home *** CD-ROM | disk | FTP | other *** search
/ LSD Docs / LSD Docs.iso / FILEZ / lsd38.dms / lsd38.adf / ArtDepartmentPro.doc.pp / ArtDepartmentPro.doc
Text File  |  1993-03-07  |  158KB  |  3,248 lines

  1.             ART DEPARTMENT PROFESSIONAL
  2.  
  3.         SOFTWARE & MANUAL BY ASDG INCORPORATED
  4.  
  5.                             DECEMBER 1, 1990
  6.  
  7.                 i
  8. CONTENTS
  9.  
  10. I    INTRODUCTION                        3
  11.  
  12. 1.    NOTICES                            5
  13.     1.1    COPYRIGHTS                    5
  14.     1.2    TRADEMARKS                    5
  15.     1.3    DISCLAIMER                    6
  16.     1.4    LICENSE                        7
  17.     1.5    SPECIFIC RESTRICTIONS                8
  18.  
  19. 2.    REGISTRATION,SUPPORT AND UPGRADES            9
  20.  
  21. 3.    WELCOME TO ADPRO                    11
  22.     3.1    HOW ADPRO DIFFERS FROM TAD            12
  23.     3.2    SYSTEM REQUIREMENTS                14
  24.     3.3    INSTALLING ADPRO                14
  25.     3.4    HOW ADPRO IS DOCUMENTED                16
  26.     3.5    HOW THIS MANUAL WAS PRODUCED            17
  27.     3.6    ABOUT ADPRO                    17
  28.     3.7    ABOUTS ASDG                    18
  29.  
  30.                 ii
  31.  
  32. 4.    ADPRO INTERNALS                        20
  33.     4.1    ADPRO'S INTERNAL DATA TYPES            20
  34.     4.2    MEMORY REQUIREMENTS                22
  35.     4.3    LIMITING MEMORY USAGE                23
  36.     4.4    REDUCING MEMORY USAGE                24
  37.     4.5    ADPRO'S BUILDING BLOCKS                25
  38.     4.6    SAVING YOUR SETTINGS                26
  39.  
  40. 5.    LOADING AN IMAGE                    27
  41.     5.1    INSTALLING NEW LOADERS                28
  42.     5.2    SELECTING A LOAD FORMAT                28
  43.     5.3    SELECTING A LOAD ORIENTATION            29
  44.     5.4    SELECTING IMAGE COMPOSTING            30
  45.     5.5    THE IMAGE COMPOSITING CONTROL PANEL        31
  46.  
  47. 6.    SAVING AN IMAGE                        35
  48.     6.1    INSTALLING NEW SAVERS                36
  49.     6.2    SELECTING A SAVE FORMAT                36
  50.     6.3    SELECTING TYPE OF DATA TO BE SAVED        37
  51.  
  52. 7.    OPERATING UPON AN IMAGE                    38
  53.     7.1    INSTALLING NEW OPERATORS            39
  54.     7.2    SELECTING AN OPERATOR                40
  55.     
  56. 8.    COLOR CONTROLS                        42
  57.     8.1    BALANCING                    42
  58.         8.1.1    BRIGHTNESS                43
  59.  
  60.                 iii
  61.  
  62.         8.1.2    Contrast                45
  63.         8.1.3    Gamma                    47
  64.         8.1.4    Red,Green,And Blue Adjustments        47
  65.         8.1.5    About the Balancing Control Panel    48
  66.         8.1.6    Saving And Loading Balance Settings    50
  67.  
  68.     8.2    Dithering                    51
  69.     
  70.     8.3    Palette                        53
  71.         8.3.1    When Are The Palette Controls Used?    53
  72.         8.3.2    Palette Status                54
  73.         8.3.3    Palette Accuracy            55
  74.         8.3.4    Colors(Total)                56
  75.         8.3.5    Colors(Used)                57    
  76.         8.3.6    Offset Color Zero            58
  77.         8.3.7    Sort Direction                59
  78.         8.3.8    Edit                    59
  79.         8.3.9    Load                    61
  80.         8.3.10    Save                    62
  81.         8.3.11    Get WB                    62
  82.  
  83. 9    Screen Controls                        64
  84.     9.1    Horizontal Size                    64
  85.     9.2    Vertical Size                    65
  86.     9.3    Number of colors                65
  87.  
  88.                 iv
  89.  
  90.     9.4    What Are A-RES and A-HAM?            67
  91.     9.5    Other Overscan Sizes                69
  92.  
  93. 10    Other Commands                        70
  94.     10.1    About                        70
  95.     10.2    Save                        70
  96.     10.3    ReDisplay                    70
  97.     10.4    Orientation                    71
  98.     10.5    Load                        71
  99.     10.6    Exit                        73
  100.     10.7    Separate                    73
  101.         10.7.1    Using ADPro Separations With 
  102.             Professional Page            77
  103.     10.8    Execute                        78
  104.  
  105. 11    The File Requester                    79
  106.     11.1    What Am I Here?                    79
  107.     11.2    Quitting The File Requester Without Selecting
  108.         A File                        80
  109.     11.3    The File List                    81
  110.         11.3.1    When The File List Is Being Created    81
  111.         11.3.2    Hidden Versus Visible Files        82
  112.         11.3.3    Scrolling The File List            83
  113.         11.3.4    Refreshing The File List        84
  114.     11.4    The Device List                    84
  115.     11.5    The Current Directory Or Drawer            85
  116.  
  117.                 v
  118.  
  119.         11.5.1    Setting The Current Directory Via    
  120.             Keyboard                86
  121.         11.5.2    Setting The Current Directory With
  122.             The Mouse                87
  123.         11.5.3    Changing The Current Directory To    
  124.             Its Parent                87
  125.     11.6    Selecting A File                87
  126.     11.7    The Hide And Show Gadgets            88
  127.         11.7.1    Toggling Between Hide And Show        89
  128.         11.7.2    Toggling Between Hide/Show and
  129.             Drawer/File                89
  130.         11.7.3    Pattern Matching In The Hide And
  131.             Show Gadgets                90
  132.  
  133. 12    Tips And Tricks                        91
  134.     12.1    Turn One bit Monochrome Images Into Gray Scale    91
  135.     12.2    Turn Low Color Images Into Higher Res Gray 
  136.         Scale                        92
  137.     12.3    Gray Scale Balancing                92
  138.     12.4    Approximating Charcoal Drawings            93
  139.     12.5    Mixing Picked And Computed Drawings        93
  140.     12.6    Eliminating Stray Dots                94
  141.     12.7    Creating Better Gradated Fills            95
  142.     12.8    Creating A Solarization                96
  143.     12.9    Merging A Color Image Into A Gray Scale Image    96
  144.     12.10    Creating Drop Shadows                97
  145.  
  146.                 vi
  147.  
  148.     12.11    Focused Color Picking                98
  149.     12.12    Tips For Compositing                99
  150.     12.13    Creating An Embossed Look            101
  151.  
  152. II    STANDARD LOADERS                    103
  153.  
  154. 13    Standard Loaders                    105
  155.     13.1    DPIIE                        105
  156.     13.2    DV21                        106
  157.     13.3    BACKFROP                    106
  158.     13.4    GIF                        109
  159.     13.5    IFF                        109
  160.     13.6    IMPULSE                        111
  161.     13.7    PCX                        112
  162.     13.8    SCREEN                        112
  163.     13.9    SCULPT                        114
  164.  
  165. III    STANDARD SAVERS                        117
  166.  
  167. 14    Standard Savers                        119
  168.     14.1    DPIIE                        120
  169.     14.2    FRAMEBUFFERS                    121
  170.     14.3    GIF                        122
  171.     14.4    IFF                        122
  172.     14.5    IMPULSE                        124
  173.     14.6    PCX                        124
  174.  
  175.                 vii
  176.  
  177.     14.7    POSTSCRIPT                    125
  178.     14.8    SCULPT                        134
  179.  
  180. IV    STANDARD OPERATORS                    135
  181.  
  182. 15    Standard Operators                    137
  183.     15.1    Apply Map                    137
  184.     15.2    Color To Gray                    138
  185.     15.3    Cropping                    139
  186.     15.4    Dynamic Range                    140
  187.     15.5    Gray To Color                    140
  188.     15.6    Horizontal Flip                    141
  189.     15.7    Line Art                    141
  190.     15.8    Negative                    143
  191.     15.9    Rectangle                    143
  192.     15.10    Remove Isolated Pixels                144
  193.     15.11    Scaling                        145
  194.         15.11.1    Pixel Aspect                148
  195.     15.12    Transport Controller                149
  196.     15.13    Vertical Flip                    149
  197.  
  198. V    AREXX INTERFACE                        151
  199.  
  200. 16    ARexx Interface                        153
  201.     16.1    Addressing ADPro                153
  202.     16.2    Results                        154
  203.  
  204.                 viii
  205.  
  206.     16.3    Opening ADPro Behind Other Screens        155
  207.     16.4    Launching ARexx Programs            156
  208.     16.5    General Syntax                    157
  209.     16.6    ARexx Command Descriptions            158
  210.         16.6.1    Load And Save Format Specification    158
  211.         16.6.2    Calling A Loader            160
  212.         16.6.3    Calling A Saver                165
  213.         16.6.4    Balancing Commands            166
  214.         16.6.5    Dither Selection            171
  215.         16.6.6    Palette Control Commands        172
  216.         16.6.7    Scaling                    180
  217.         16.6.8    Operators                181
  218.         16.6.9    Color Separation Commands        188
  219.         16.6.10    Execute                    194
  220.         16.6.11    Render Type                194
  221.         16.6.12    Exiting ADPro                195
  222.         16.6.13    Screen Type                195
  223.         16.6.14    Load Orientation            196
  224.         16.6.15    Additionl ARexx Commands        197
  225.     16.7    Starting ADPro Via ARexx            205
  226.  
  227. VI    INDEX                            209
  228.  
  229.                 ix
  230.  
  231.             LIST OF FIGURES
  232.  
  233. 4.1    ADPro's Building Blocks                    25
  234. 5.1    The image compositing control panel            31
  235. 7.1    The Image Operator box,showing the operator and
  236.     execute op buttons                    40
  237. 8.1    Data flow within ADPro                    43
  238. 8.2    A linear(or neutral)color map                44
  239. 8.3    A color map showing an increase in brightness        45
  240. 8.4    A color map showing a decrease in contrast        46
  241. 8.5    A color map showing an example of gamma correction    48
  242. 8.6    The Balance control panel                49
  243. 8.7    The Palette control panel                54
  244. 10.1    The Separation control panel                74
  245. 11.1    The file requester used in ADPro            80
  246.  
  247.                 x
  248.  
  249. 13.1    The BACKDROP loader control panel            107
  250. 14.1    The primary PostScript saver control panel        126
  251. 14.2    Various PostScript metrics                128
  252. 14.3    The second PostScript saver control panel        129
  253. 14.4    The third and final PostScript saver control panel    132
  254. 15.1    The Rectangle control panel                144
  255. 15.2    The Scaling control panel                147
  256.  
  257.                 xi
  258.  
  259.             LIST OF TABLES
  260.  
  261. 5.1    What types of images can be merged into what types
  262.     of previously defined raw image data            32
  263. 5.2    Example mix levels and their effect            33
  264. 9.1    The horizontal resolutions supported by ADPro        65
  265. 9.2    The vertical resolutions supported by ADPro        66
  266. 9.3    Color modes and other information            66
  267. 16.1    Dither methods and their identifiers            171
  268. 16.2    Mask values for setting the screen type            195
  269.  
  270.                 1
  271.  
  272. (PAGES 2-10 NOT TYPED AS THEY CONTAIN INFO THAT PIRATES AREN'T INTERESTED IN)
  273.  
  274.  
  275.             CHAPTER 3 - WELCOME TO ADPRO
  276.  
  277. Art Department Professional(ADPro)is an integrated set of powerful image
  278. processing tools which facilitate the creation of high quality pictures on the
  279. Commodore Amiga personal computer. Examples of the intended users of ADPro
  280. include:
  281.  
  282. ADPro can be used to convert images between diverse input file formats. ADPro
  283. uses external programs to actually load and save images. As a result,ADPro can
  284. be extended to read and write new of diffeent formats just by adding additional
  285. modules.
  286. ADPro can be used as a high quality rendering engine for Amiga video use. That
  287. is,any image data loaded into ADPro can be rendered in any Amiga video format
  288. using ASDG's acclaimed rendering technology. ADPro has many applications in
  289. animation and Desktop presentation.
  290. ADPro supports image compositioning in full 24 bit-plane color. This affords
  291. fantastic new power to the print and video user.
  292.  
  293.                 11
  294.  
  295. ADPro can be used as a source of high quality color separations for Desktop
  296. publishing applications. ADPro can produce separations in both 12 and 24bit-
  297. planes with excellent print quality.
  298. ADPro can be used to render images to be used for heat-transfer onto materials
  299. such as cotton shirts. Using ADPro's separation capabilities,films may be
  300. prepared for three and four color silk screening.
  301. ADPro may be used to augment the quality of the output from many 3D modelling
  302. packages since ADPro can render images from 24 bit-planes faster and better
  303. than most 3D packages can perform this function themselves.
  304.  
  305. 3.1 HOW ADPRO DIFFERS FROM TAD
  306. ADPro represents a quantum leap over the original Art Department in terms of
  307. its power and flexibility. The Art Department(TAD)continues to be sold and
  308. represents ASDG's entry level image processing system for the Commodore Amiga.
  309. ADPro,on the other hand,represents a high end tool for the professional or
  310. power user.
  311. Some of the differences between ADPro and TAD are highlighted below:
  312. ADPro can save in multiple formats using run-time loadable Saver modules. This
  313.  
  314.                 12
  315.  
  316. means that ADPro can be used for completely generalized image format
  317. conversion. This new feature also allows ADPro to be used as a general purpose
  318. front-end for image input,output and display hardware such as scanners and
  319. display boards.
  320. Many of the image processing functions built into TAD are now run-time
  321. loadable. These modules are called Operators. Because Operators are run-time
  322. loadable,ASDG can release additional Operators from time to time without
  323. requiring an upgrade to the main program.
  324. ADPro offers true color image compositing which TAD did not. Image compositing
  325. allows you to actually edit 24 bit-lane images even if you do not have a 24 bit
  326. display board or paint program.
  327. ADPro can be controlled via ARexx making it a powerful automated image
  328. processing engine for batch,bulk,or network applications.
  329. ADPro allows the user to choose between standard Amiga palette support and a
  330. more accurate enhanced palette mode. The enhanced palette mode yeilds higher
  331. quality when producing images for display upon such hardware as IBM compatible
  332. VGA and Super-VGA displays and the Commodore Hi-Res Graphics Adapter.
  333. ADPro comes with many additional Loaders,Savers,and Operators as compared to
  334. TAD.
  335.  
  336.                 13
  337.  
  338. 3.2 SYSTEM REQUIREMENTS
  339. ADPro is compatible with the entire family of Amiga computers. These include
  340. the A500,A1000,A2000,A2500,A2500/30 and A3000 Amiga computers. ADPro was
  341. designed to run under KickStart versions 1.2,1.3,and 2.0.
  342. By its very nature,ADPro requires a lot of memory. In fact,ADPro can utilize as
  343. much contiguous memory as you have on your machine. While it can run in as
  344. little as one megabyte of memory,we suggest a minimum of four megabytes of
  345. expansion memory in order to get any substantial work accomplished.
  346. If your expansion memory is spread over multiple boards,be sure to invoke the
  347. Commodore supplied command Mergemem in your Startup-Sequence if you don't
  348. already do so.
  349. If Mergemem is not run,you will not get the full benefit of your expanded
  350. memory.
  351. Remember that fast memory must be contiguous for ADPro to make full use of it.
  352. For more information about ADPro's memory requirements and for a greater
  353. understanding of how ADPro internally stores image data,please refer to Chapter
  354. 4.
  355.  
  356. 3.3 INSTALLING ADPRO
  357. We anticipate that most of ADPro will want to install the program on a hard
  358. disk drive. To do so,simply double click on the Install icon found in the main
  359. drawer of the ADPro distribution disk. The Install program performs the
  360. following tasks for you:
  361. 1. It will copy the Dawson/Fox requester library found in the LIBS directory on
  362. the ADPro distribution disk to your LIBS: directory. This library must be
  363. present in your LIBS: directory in order for ADPro to operate.
  364. 2. It will ask you to select a directory in which to install ADPro. You should
  365. select a directory which is accessible from the WorkBench. Once you have made
  366. that selection,the Install program will copy the ADPro program and its icon to
  367. the directory you've selected.
  368. 3. It will then create directories for the Loaders,Savers,and Operators which
  369. come with ADPro and copy these from the distribution disk to the newly created
  370. directories.
  371. If you don't have a hard disk drive,you may want to create a bootable WorkBench
  372. floppy with the ADPro program on it,or you might choose to boot from a standard
  373. floppy and run ADPro from a copy of its distribution disk.
  374. In either case,remember that the requester library used by ADPro must be copied
  375. into your LIBS: directory. This can be done for you by the Install program.
  376. If you choose not to install ADPro on your system floppy,simply terminate the
  377. Install program after it has copied the requester library to your system disk.
  378. If you intend to run ADPro only from the WorkBench,then you need to do nothing
  379. else.
  380.  
  381.                 15
  382.  
  383. However,if you wish to run ADPro from the CLI,you will also need to add an
  384. ASSIGN to your Startup-Sequence. For example,if you select the directory 
  385. DH1:Foo/Bar to contain ADPro,then the following line should appear in your
  386. Startup-Sequence.
  387.  
  388.         assign ADPro:  DH1:Foo/Bar
  389.  
  390. 3.4 HOW ADPRO IS DOCUMENTED
  391. ADPro is a very easy program to use. However,its use does require at least a
  392. passing familiarity with general Amiga usage and practices. This manual assumes
  393. that thr eader has such a familiarity. If more basic information is required
  394. about operating your Amiga than is provided in this manual,please consult the
  395. introductory texts that cam with your machine. We also stongly suggest that new
  396. Amiga owners contact their local Amiga user groups for basic training and help.
  397. The documentation for ADPro is divided into several logical parts. These are:
  398. Part 1 - Contains background and general information about the usage of ADPro.
  399. Also contained in this part are numberous tips and tricks for advanced use of
  400. ADPro.
  401. Part 2 - Contains a detailed discussion of each of the standard Loaders.
  402. Part 3 - Contains a detailed discussion of each of the standard Savers.
  403. Part 4 - Contains a detailed discussion of each of the standard Operators.
  404. Part 5 - Contains a dettailed discussion of how ADPro is controlled from ARexx.
  405. Part 6 - Contains an index for the manual.
  406.  
  407. 3.5 HOW THIS MANUAL WAS PRODUCED
  408. This manual was created and typeset on a Commodore Amiga A2000 personal
  409. computer using AmigaTeX from Radical Eye Software. The text itself was created
  410. using ASDG's CygnusEd Professional Release 2. The master was printed full size,
  411. two-up,on an Apple LaserWriter II driven at 57,600 baud by an ASDG Dual Serial
  412. Board.
  413. In order to produce the best product possible,ASDG routinely updates the
  414. content of their manuals each time a print run is required. If you should find
  415. any technical,typographical,grammatical or any other type of error in your
  416. manual,please relay this information to ASDG so that we can correct future
  417. print runs.
  418.  
  419. 3.6 ABOUT ADPRO
  420. ADPro represents the accumulated color processing technology developed at ASDG
  421. Incorporated. ADPro borrows heavily from the work done in creating ASDG's color
  422. scanner products(ScanLab/100 and Professional ScanLab)and in creating The Art
  423. Department(TAD).
  424.  
  425.                 17
  426.  
  427. ASDG has been assisted by its beta testers and those you who have sent in
  428. manual corrections and program suggestions. To all of you,we extend our
  429. appreciation. We would also like to thank those of you who have supported our
  430. company's efforts by not pirating our software.
  431.  
  432. 3.7 ABOUT ASDG
  433. ASDG Incorporated has been a leader in technological innovation and quality
  434. since the Amiga premiered in 1985. The company has created a number of first in
  435. the Amiga market place including the first recoverable ram disk,memory boards
  436. for the A2000,floppy accelerator,IEEE-488 interface,expansion serial board,and
  437. the first 24 bit-plane color image processing system.
  438. In addition,the company has been honored by being the first inductee into
  439. Commodore Magazine's "the Amiga Public Domain Hall of Fame",and the company
  440. president Perry Kivolowitz,was given the first Amiga Community Service Award by
  441. Amazing Computing Magazine.
  442. In recent years we have refined our focus to be the input,processing and output
  443. of color images. In this area,we're always looking for quality products which
  444. will enhance our product line. Please feel free to contact us concerning our
  445. possible publishing or marketing of your product.
  446. We can be reached at:
  447.  
  448.                 18
  449.  
  450.             ASDG INCORPORATED
  451.             925 STEWART SREET
  452.             MADISON, WISCONSIN  53713
  453.             (608)273-6585(voice)
  454.  
  455.                 19
  456.  
  457.             CHAPTER 4 - ADPRO INTERNALS
  458.  
  459. This chapter describes how ADPro internally stores and manages image data in
  460. memory. This information is critical to understanding ADPro's memory
  461. requirements as well as providing insight into the internal operation of ADPro.
  462.  
  463. 4.1 ADPRO'S INTERNAL DATA TYPES
  464. Internally to ADPro,image data can be only one of several types. Understanding
  465. the differences between these data types will help you understand how and why
  466. ADPro works the way it does.
  467. The first distinction between image data types is that of between raw and
  468. rendered image data. Rendered image data is data which contains color mapped
  469. information. Images such as those which are displayable on the Amiga's screen
  470. are examples of rendered image data. An IFF file(for example) which contains a
  471.  
  472.                 20
  473.  
  474. 16 color image and can be displayed with any viewing program contains a color
  475. map describing what actual color each value in the image should be displayed
  476. as. Without the color map information,the image data can be unregnizable.
  477. ADPro can create,read,process,or write rendered data with up to 256 color
  478. mapped colors. A 256 color rendered image contains 8 bit-planes. Therefore,
  479. ADPro can create,read,process or write rendered data with up to 8 bit-planes.
  480. Raw image data is divided into color and gray scale types. Common to both types
  481. of raw image data is that a color map is not required in order to make the
  482. image data recognizable. Gray scale raw image data is stored internally in
  483. ADPro in 8 bit-planes or 256 shades of gray. Color raw image data is stored
  484. internally in ADPro in 24 bit-planes or 16.7 million shades of color.
  485. Memory permitting,ADPro always converts rendered image data into raw image data
  486. during a load operation. The color map of a rendered image file is examined. if
  487. it contains only shades of gray,the rendered image data is converted into an 8
  488. bit-plane raw gray image. If any non-gray colors are detected,the image is
  489. converted into a 24 bit-plane raw color image.
  490. The execute button causes ADPro to process raw image data into rendered image
  491. data. 
  492. Nearly all of the functions which ADPro can perform require the presence of raw
  493. image data. Only one of color or gray raw image data. Only one of color or gray
  494. raw image data can be processed at one time. Operators are provided to convert
  495. between the internal formats of color and gray raw image data.
  496. Some functions of ADPro require rendered image data,and some require only one
  497.  
  498.                 21
  499.  
  500. type of raw image data but not the other. ADPro will tell you anytime you
  501. request an operation for which the appropriate type of data is not currently
  502. available.
  503. While you cannot process both raw color and raw gray scale image data at the
  504. same time,ADPro does permit one of these types of image data to be resident in
  505. memory along with rendered image data.
  506.  
  507. 4.2 MEMORY REQUIREMENTS
  508. ADPro can use all of the contiguous fast memory available on your system. The
  509. more contiguous fast memory you have,the larger the bit-maps(images)you will be
  510. able to process.
  511. Ignoring the differences between the different file formats that ADPro can
  512. process,ADPro really loads only two types of images:color and gray scale.
  513. ADPro defines a gray scale image to be any image in which every color in the
  514. image's palette is a shade of gray(i.e.:the red,green,and blue content of each
  515. color are equal). ADPro considers anything which is not a gray scale image
  516. under this definition to be a color image.
  517. To calculate how much memory would be required for a given color image,you can
  518. use the following formula as a guide:
  519.  
  520.         Minimum Bytes Needed      =
  521.                          color
  522.         Width      * Height      *4
  523.              pixels        pixels
  524.  
  525. This guide will tell you the approximate minimum amount of contiguous fast
  526. memory(in bytes)required to process a color image of a given size. The multi-
  527.  
  528.                 22
  529.  
  530. plication by 4 to give the number of bytes required is actually a short hand
  531. for 32/8. The 32 is the number of bit-planes that ADPro uses for all of its
  532. processing. The division by 8 turns the number of bits into bytes(8 bits in a
  533. byte).
  534. Take as example,an image measuring 640 by 400 pixels in size. This would
  535. require a minimum of 1024000 bytes of contiguous available memory to be able to
  536. take advantage of all of ADPro's processing capabilities. Of this space,three
  537. quarters will be used for 24 bit-plane raw image data. The remaining quarter is
  538. used to hold rendered display data.
  539. ADPro converts all color images into 24 bit-plane data when the image is
  540. loaded. Gray scale image data is converted into 8 bit-planes rather than 24.
  541. This produces a memory requirement rule-of-thumb as follows:
  542.  
  543.             Minimum Bytes Needed    =
  544.                         gray
  545.             Width      * Height      * 2
  546.                  pixels        pixels
  547.  
  548. The same 640 by 400 pixel image(as in the previous example)would require a
  549. minimum of 512000 bytes of contiguous memory if it were a gray scale image
  550. rather than color.
  551.  
  552. 4.3 LIMITING MEMORY USAGE
  553. On systems with a great deal of memory,you can limit the amount of fast memory
  554. which ADPro will allocate. By default,ADPro will allocate 128K less than the
  555. largest fast memory block which is available. If you wish ADPro to use less
  556.  
  557.                 23
  558.  
  559. memory than this default amount,you can specify this in two ways.
  560. From the WorkBench,you can set a tool type called MAXMEM to the number of bytes
  561. to which you wish to limit ADPro's primary image buffer. For example,specifying
  562. MAXMEM=3000000 will limit ADPro's primary image buffer to 3,000,000 bytes even
  563. if you have 8 megabytes of free contiguous fast memory available.
  564. Tool types can be set from the WorkBench using the WorkBench Info command. For
  565. more information about how this is done,please consult your introductory Amiga
  566. texts.
  567. From the CLI,you may specify a command line option of -m BYTES. For example,
  568. specifying ADPRO -m 3000000 will have the same effect as above.
  569. The amount of fast memory used will be slightly larger than the amount
  570. specified as a memory limit. This extra space is used to hold the program's
  571. code in memory as well as some small data structures.
  572.  
  573. 4.4 REDUCING MEMORY USAGE
  574. ADPro's enhanced palette support consumes as much as 300,000 bytes of memory.
  575. If you know that you will not make use of this feature,you can disable it and
  576. reclaim the memory it would have used.
  577. From the command line,if you include the -3 option,enhanced palette operation
  578. will be disabled.
  579. From the WorkBench,you can specify a tool type called NOENHANCED which must(if
  580. present)be set to eith a zero or non-zero value. If set to a non-zero value,en-
  581.  
  582.                 24
  583.  
  584.                 
  585.             FIGURE 4.1:ADPRO'S BULDING BLOCKS
  586.  
  587. hanced palette operations are disabled. For example,specifying NOENHANCED=0
  588. permits enhanced palette operations while NOENHANCED=1 disables enhanced
  589. palette operations.
  590. See section 8.3.3 for more information about enhanced palette operations.
  591.  
  592. 4.5 ADPRO'S BUILDING BLOCKS
  593. Modules called Loaders,Savers,and Operators have already been mentioned many
  594. times. Figure 4.1 indicates how these modules interact within ADPro.
  595. As you can see,Loaders are a source of image data. In general,Loaders are
  596. programs which read and interpret diverse image file formats from disk. However
  597. Loaders can read or generate their data from many other sources besides simply
  598. reading data from a disk drive. For example,a Loader can be written which
  599. controls a video digitizer allowing ADPro to seamlessly load images directly
  600. from the digitizer.
  601. Savers are used as a destination for image data. Savers generally encode raw or
  602.  
  603.                 25
  604.  
  605. rendered image data into a particular image file format for writing to a hard
  606. disk drive. However,Savers can also be used for controlling devices which are
  607. output in nature. For example,a Saver can be written which controls a
  608. particular frame buffer. The act of "saving" an image to such a device would
  609. cause the raw or rendered image data to be transferred to,and displayed upon,
  610. the fram buffer.
  611. Finally,Operators are general purpose processing modules which are used to
  612. perform the various image processing functions which ADPro supports. Operators
  613. are extremely flexible since they allow input,processing and output of either
  614. raw or rendered image data.
  615.  
  616. 4.6 SAVING YOUR SETTINGS
  617. When each of the loaders,savers,and operators are considered,along with ADPro
  618. itself,there are hundred of individual settings which may be made. As a
  619. convenience,ADPro will store most of these settings in a file called
  620. ADProDefaults.
  621. When ADPro is exited,these settings will be updated. The next time ADPro is
  622. executed,these settings will be restored.
  623.  
  624.                 26
  625.  
  626.             CHAPTER 5 - LOADING AN IMAGE
  627.  
  628. This chapter discusses the general nature of loading an image into ADPro.
  629. Specific information about individual Loaders is contained in Part 2 of this
  630. manual. Also,most Loaders make use of the Dawson/Fox file requester included
  631. with ADPro. For more information about the file requester,please turn to
  632. Chapter 11.
  633. One of the design goals of ADPro was to allow it to work with as many diverse
  634. file formats as possible. ADPro was designed with a modular Loader interface so
  635. that diverse formats could be added as they became available without requiring
  636. any change to ADPro.
  637. As has been said,Loaders are separate programs which are run by ADPro when you
  638. select the load command. These programs must reside in a specific directory so
  639. that ADPro can locate them at run time. The Install program that comes with
  640. ADPro automatically creates a directory called Loaders2 in the same directory
  641. in which ADPro is installed.
  642. If you execute ADPro from the WorkBench,ADPro can automatically locate the
  643. Loaders2 directory because it is in the same directory as ADPro.
  644.  
  645.                 27
  646.  
  647. However,if you want to execute ADPro from the CLI,you must first execute an
  648. ASSIGN of ADPro: to the directory in which ADPro is located. Preferably,the
  649. ASSIGN should be done in your startup-sequence. For an example of this,please
  650. see the section Installing ADPro.
  651.  
  652. 5.1 INSTALLING NEW LOADERS
  653. Should you purchase additional Module Packs in the future,they can be installed
  654. using the installation procedures which they contain. Please consult the manual
  655. which accompanies each Module Pack for more information.
  656.  
  657. 5.2 SELECING A LOAD FORMAT
  658. In the upper left corner of the ADPro screen,you'll see the word Load. Next to
  659. this word there is a button which(upon entering ADPro for the first time)is
  660. labeled IFf. This button is called the load format button. Repeatedly selecting
  661. the load format button(by clicking the left mouse button when the mouse cursor
  662. is located over the load format button)causes ADPro to cycle through the
  663. Loaders which are currently installed.
  664. Since there may be many Loaders installed,the sequence in which they will be
  665. successively displayed in the load format button can become quite lengthy. As a
  666. convenience,the load format button is logically divided into two halves. If you
  667.  
  668.                 28
  669.  
  670. click on the left half of the button,the order in which it sequences through
  671. the installed Loaders will be the opposite of that which is displayed if you
  672. click upon the right half of the button.
  673. Thus,if you successively click on the right half of the button but accidentally
  674. advance too far,click on the left half of the button to quickly return to the
  675. load format you want.
  676. notice that the loaders are sorted alphabetically.
  677. once you have selected the load format you wish to employ,selecting the load
  678. button will cause the selected Loader to execute.
  679.  
  680. 5.3 SELECTING A LOAD ORIENTATION
  681. ADPro can perform a 90 degree counter-clockwise rotation of the image data
  682. during a load operation. This is accomplished using the orientation button
  683. which is immediately to the left of the load button.
  684. Note that the orientation button affects data only during a load operation.
  685. Using a combination of the vertical and horizontal flip operators and the
  686. orientation button,ADPro can produce 90 degree rotations through 0,90,180 and
  687. 270 degrees.
  688. These can be performed as follows:
  689. 0 Defrees -  Load the image in the Port or portrait orientation.
  690.  
  691.                 29
  692.  
  693. 180 Degress -  Load the image in the Port or portrait orientation and then
  694. perform both a horizontal and vertical flip. The resulting data will be rotated
  695. 180 degrees with resepct to the data loaded from disk.
  696. 270 Degrees - Load the image in the Land or landscape orientation. The
  697. resulting image will be rotated 270 degrees with respect to the data residing
  698. on disk.
  699. 90 Degrees - Load the image in Land or landscape orientation and then perform
  700. both a horizontal and vertical flip. The resulting data will be rotated 90
  701. degrees with respect to the data loaded from disk.
  702.  
  703. 5.4 SELECTING IMAGE COMPOSITING
  704. ADPro supports a very powerful image compositing feature which can be enabled
  705. by setting the compositing button to Comp. The default value for this button is
  706. to disable image compositing. In this case,the button will be marked Replc.
  707. When the compositing button is in the Comp setting,and a load operation is
  708. performed,you will be presented with the image compositing control panel if the
  709. currently selected Loader supports image compositing. If the currently selected
  710. Loader does not support image compositing,the setting of this button has no
  711. effect.
  712.  
  713.                 30
  714.  
  715.         FIGURE 5.1:THE IMAGE COMPOSITING CONTROL PANEL.
  716.  
  717. 5.5 THE IMAGE COMPOSITING CONTROL PANEL
  718. If a loader supports image compositing,and compositing is enabled,after you
  719. select a file to be loaded the loader will display the image compositing
  720. control panel. This panel is shown in Figure 5.1.
  721. When performing a non-compositing load operation,the loader discards the
  722. previous raw and rendered data before loading new data. When compositing,the
  723. loader merges the previously defined raw data with the new image being loaded.
  724. The exact balance of the merging operation is under your control.
  725. A file containing a gray scale image can be merged(composited)into gray scale
  726. or color raw image data. A color image may not be directly merged into gray
  727.  
  728.                 31
  729.  
  730.         CONTENTS    TYPE OF RAW DATA IN MEMORY
  731.           FILE        GRAY        COLOR
  732.          GRAY        YES        YES
  733.          COLOR        NO        YES
  734.  
  735. TABLE 5.1: WHAT TYPES OF IMAGES CAN BE MERGED INTO WHAT TYPES OF PREVIOUSLY
  736. DEFINED RAW IMAGE DATA.
  737.  
  738. scale raw image data. Table 5.1 summariezes this restriction.
  739. To merge a color image into a gray scale image,first convert the logical
  740. structure of the gray scale image into that of a color image using the gray to
  741. color operator described in section 15.5.
  742. In the compositing control panel shown in Figure 5.1,the destination sizes
  743. correspond to the width and height of the previously defined raw image into
  744. which the file to be loaded will be merged.
  745. The Source width and height denotes the full size of the image to be loaded.
  746. The offsets(x and y)give the position of the top left corner of the image to be
  747. loaded relative to the top left corner of the destination image. An offset of
  748. 0,0 means that the top left corner of both the source and the destination will
  749. coincide.
  750. Typing offsets into the supplied gadgets can be used to set the offset of the
  751. top left-hand corner of the image to be merged relative to the top left-hand
  752. corner of the original image. Note that negative offsets are perfectly
  753. acceptable.
  754. The mix level,which can range from 0 to 100,can be set by typing the desired
  755. value to be used in the supplied gadget. It represents what weighting the
  756. pixels in the new image should have when being averaged with pixels from the
  757.  
  758.                 32
  759.  
  760. MIX      WEIGHT OF PIXELS        WEIGHT OF PIXELS
  761. LEVEL   FROM  LOADED  IMAGE         FROM   PREVIOUS   IMAGE
  762. 100          100                0
  763. 50           50                              50
  764. 25             25                              75
  765.  
  766. TABLE 5.2:EXAMPLE MIX LEVELS AND THEIR EFFECT.
  767.  
  768. destination image. Table 5.2 shows how various mix levels affect the weighted
  769. average between the new and old images.
  770. So,for example,a mix level of 100 means that the new image data is given a
  771. weighting of 100 percent. Thus,the new pixel completely replaces the old pixel
  772. where the new image and the old image overlap. A mix level of 50 means that you
  773. will get a straight arithmetic average between new and old pixels.
  774. The gadgets marked R,G and B are used to specify a 24 bit color value which
  775. will be regarded as completely transparant during the image compositing
  776. operation. One hundred percent of the old image data will be preserved for each
  777. pixel in the newly loaded data which matches the color specified in these
  778. gadgets.
  779. When compositing a gray scale image,the value of the gadget marked R is used
  780. for the transparancy operation. A value of -1 in any of the gadgets disables
  781. the transparancy check.
  782. The button marked OK will merge the specified image into the currently defined
  783. raw image. The button marked CANCEL will abort the compositing as well as the
  784.  
  785.                 33
  786.  
  787. load operation.
  788. The button marked No Comp will continue with the load operation but not perform
  789. compositing. This will cause the raw image to be completely replaced by the
  790. newly loaded data as if you had disabled image compositing.
  791. Typing SHIFT-RETURN is equivalent to selecting the OK button. Typing RETURN
  792. while cursor is in either of the offset gadgets will cause you to alternate to
  793. the other gadget. Typing RETURN while the cursor is in any of the transparancy
  794. gadgets or the mix gadget will cause the cursor to apear in the next gadget in
  795. sequence. Typing ALT-RETURN causes the cursor to alternate between the offset
  796. gadgets and the mix and transparancy gadgets.
  797. With creative use of the image compositing capability,a myriad of special
  798. effects can be performed. For example,you can use a combination of a standard
  799. Amiga paint package and the image compositing function in ADPro to perform true
  800. color(24 bit-plane)image masking. Specifically,you can do things such as remove
  801. just one person from a scan of a group photo and place that person into the
  802. middle of a 24 bit-plane ray tracing.
  803.  
  804.                 34
  805.  
  806.             CHAPTER 6 - SAVING AN IMAGE
  807.  
  808. This chapter discusses the general nature of saving an image from ADPro.
  809. Specific information about individual Savers is contained in Part 3 of this
  810. manual. Also,most Savers make use of the Dawson/Fox file requester included
  811. with ADPro. For more information specifically about the file requester,please
  812. turn to Chapter 11.
  813. As mentioned previously,a design goal of ADPro was to allow it to work with as
  814. many diverse file formats as possible. ADPro was designed with a modular Saver
  815. interface so that diverse formats could be added as they because available
  816. without requiring any change to ADPro.
  817. Savers are separate programs which are run by ADPro when you select the save
  818. command. These programs must reside in a specific directory so that ADPro can
  819. locate them at run time. The Install program that comes with ADPro
  820. automatically creates a directory called Savers2 in the same directory in which
  821. ADPro is installed.
  822.  
  823.                 35
  824.  
  825. If you execute ADPro from the WorkBench,ADPro can automatically locate the
  826. Savers2 directory because it is in the same directory as ADPro.
  827. However,if you execute ADPro from the CLI,you must first execute an ASSIGN
  828. (preferably from your startup-sequence)of ADPro: to the directory in which
  829. ADPro is located. For an example of this,please see the section Installing
  830. ADPro.
  831.  
  832. 6.1 INSTALLING NEW SAVERS
  833. Should you purchase additional Module Packs in the future,they can be installed
  834. using the installation procedures which they contain. Please consult the manual
  835. which accompanies each Module Pack for more information.
  836.  
  837. 6.2 SELECTING A SAVE FORMAT
  838. In the upper left corner of the ADPro screen,you'll see the word Save. Next to
  839. this word there is a button which(upon entering ADPro for the first tme)is
  840. labeled IFF. This button is called the save format button. Repeatedly selecting
  841. the save format button(by clicking the left mouse button when the mouse cursor
  842. is located over the button)causes ADPro to cycle throught the Savers which are
  843. currently installed.
  844. Since there may be many Savers installed,the sequence in which they will be
  845. successively displayed in the save format button can become quite lengthy. As a
  846. convenience,the save format button is logically divided into two halves. If you
  847.  
  848.                 36
  849.  
  850. click on the left half of the button,the order in which it sequences through
  851. the installed Savers will be the opposite of that which is displayed if you
  852. click upon the right half of the button.
  853. Thus,if you successively click on the right half of the button but accidentally
  854. advance too far,click on the left half of the button to quickly return to the
  855. format you want.
  856. Notice that the savers are presented in alphabetical order.
  857. Once you have selected the format you wish to employ,selecting the save button
  858. will cause the selected Saver to execute.
  859.  
  860. 6.3 SELECTING TYPE OF DATA TO BE SAVED
  861. Recall from Chapter 4 that ADPro can maintain up to two different types of
  862. image data internally,rendered and raw. Most Savers will give you an
  863. opportunity to select which type of image data it will accept. If you do not
  864. have the appropriate type of data available at the time the Saver is executed,
  865. it will alert you to this deficiency.
  866.  
  867.                 37
  868.  
  869.             CHAPTER 7 - OPERATING UPON AN IMAGE
  870.  
  871. This chapter discusses the general nature of Operators within ADPro,
  872. interrupting an Operator in mid-operation will leave partially operated-upon
  873. data in memory or may in some cases cause all data to be lost(if interrupted).
  874. Operators are separate programs which are run by ADPro when you select the
  875. execute op button located in the Image Operator area of the ADPro screen. These
  876. programs must reside in a specific directory so that ADPro can locate them at
  877. run time. The Install program that comes with ADPro automatically creates a
  878. directory called Operators2 in the same directory in which ADPro is installed.
  879. If you execute ADPro from the WorkBench,ADPro can automatically locate the
  880. Operators2 directory because it is in the same directory as ADPro.
  881. However,if you want to execute ADPro from the CLI,you must first execute an
  882. ASSIGN of ADPro: to the directory in which ADPro is located. For an example of
  883. this,please see the section Installing ADPro.
  884.  
  885. 7.1 INSTALLING NEW OPERATORS
  886. Should you purchase additional Module Packs in the future,they can be installed
  887. using the installation procedures which they contain. Please consult the manual
  888. which accompanies each Module Pack for more information.
  889.  
  890.                 39
  891.  
  892.             IMAGE OPERATORS
  893.             COLOR_TO_GRAY
  894.             EXECUTE OP
  895.             SCALE
  896.              IMAGE      SIZE
  897.         W:     0        H:    0
  898.  
  899. FIGURE 7.1:THE IMAGE OPERATOR BOX,SHOWING THE OPERATOR AND EXECUTE OP BUTTONS.
  900.  
  901. 7.2 SELECTING AN OPERATOR
  902. In the lower left corner of the ADPro screen,you'll see the box marked Image
  903. Operators. This box is depicted in Figure 7.1. In this box there are three
  904. buttons(with the middle one being marked Execute Op. The button above the one
  905. marked Execute Op is used to select which Operator will be invoked when the
  906. execute op button is depressed.
  907. For convenience,the scale operator has a button of its own located beneath the
  908. Execute Op button.
  909. Repeatedly selecting the Operator button(by clicking the left mouse button when
  910. the mouse cursor is located over the button)causes ADPro to cycle through the
  911. Operators which are currently installed.
  912. Since there may be many operators installed,the sequence in which they will be
  913.  
  914.                 40
  915.  
  916. successively displayed in the operator button can become quite lengthy. As a
  917. convenience,the operator button is logically divided into two halves. If you
  918. click on the left half of the button,the order in which it sequences through
  919. the installed Operators will be the opposite of that which is displayed if you
  920. click upon the right half of the button.
  921. Thus,if you successively click on the right half of the button but accidentally
  922. advance too far,click on the left half of the button to quickly return to the
  923. format you want.
  924. Once you have selected the Operator you wish to employ,selecting the execute op
  925. button immediately below the operator button will cause the selected Operator
  926. to execute.
  927.  
  928.                 41
  929.  
  930.             CHAPTER 8 - COLOR CONTROLS
  931.  
  932. This chapter describes the functions located in the Color Controls area of
  933. ADPro. Each of the functions located in this area contributes to or affects the
  934. choice of colors which will be used in the rendering calculation.
  935. Figure 8.1 depicts how these controls fit in to the flow of data through ADPro.
  936. Notice that the color controls merely filter but do not actually modify the raw
  937. data. Therefore,you can always undo a change made to a color control and get
  938. back to the original rendered image.
  939.  
  940. 8.1 BALANCING
  941. Whenever ADPro renders an image,it passes all of the raw color or gray scale
  942. data through a series of adjustments before actually using them in the
  943. rendering calculation. Before discussing the color balancing features of ADPro,
  944. let's first give some background information about how the adjustments are
  945.  
  946.                 42
  947.  
  948. Raw       Color                          Final
  949. Data    Adjustments    Dithering       Rendering        Image
  950.  
  951.                                          Color
  952.                                         Palette
  953.  
  954. FIGURE 8.1:DATA FLOW WITHIN ADPRO
  955.  
  956. applied.
  957. ADPro stores each pixel of a color image as 3 values(one each for red,green and
  958. blue)each of which can range from 0 to 255. Gray scale pixels are stored as a
  959. single value which can range from 0 to 255.
  960. Figure 8.2 shows a linear or neutral color map. A color map is a relationship
  961. between input intensities and output intensities. Internally,ADPro maintains a
  962. color map for each of the red,green,and blue components of colored data,and a
  963. gray scale map for gray data.
  964. The color map shown in Figure 8.2 is said to be linear or neutral because it is
  965. a single straight line going from corner to corner in the color map. Notice
  966. that an incoming intensity of 128 is output unchanged as 128. The same is true
  967. for all intensities from 0 to 255,that is,they are output unchanged.
  968.  
  969. 8.1.1 BRIGHTNESS
  970. The brightness adjustment globally modifies the general brightness of an image.
  971. It does this by uniformly shifting the color map upwards or downwards. This is
  972.  
  973.                 43
  974.  
  975. FIGURE 8.2:A LINEAR(OR NEUTRAL) COLOR MAP.
  976.  
  977. shown in Figure 8.3. Here,the two input intensities are 128 and 160(a
  978. difference of 32 intensity levels). Notice that they are output as 192 and 224
  979. (with exactly the same difference in intensity levels). Similarly,all input
  980. intensities will be shifted upwards(or made brighter)by the color map shown in
  981. Figure 8.3.
  982. The brightness adjustment is not without its drawbacks. Notice that an input
  983. value of 0(in the color map shown in Figure 8.3)is output as 64. This means
  984. that the darkest intensity in the image will have an intensity of at least 64
  985. which may not be acceptable. Also,note that all values from 192 to 255 all map
  986. to the same value,255. This means all details which had intensity levels in
  987. that range will become lost.
  988. The brightness control in ADPro ranges from -50 to 50 with 0 being the neutral
  989. value. Setting the brightness control to a positive value uniformly shifts the 
  990.  
  991.                 44
  992.  
  993. FIGURE 8.3:A COLOR MAP SHOWING AN INCREASE IN BRIGHTNESS.
  994.  
  995. color map upward(towards a brighter image). Similarly,a negative value causes
  996. the image to be shifted towards darkness.
  997.  
  998. 8.1.2 CONTRAST
  999. The contrast control globally modifies the contrast of an image. Contrast
  1000. adjustments can be visualized by thinking of the neutral color map being
  1001. pivoted around its center point. At one extreme,the color map becomes flat
  1002. which means that all input intensities map to the same output intensity(no
  1003. contrast). The other extreme is a vertical line for a color map. This produces
  1004. an image with exactly two intensities(maximum contrast).
  1005. Figure 8.4 shows how input intensities 128 and 160(a differnce of 32 intensity
  1006.  
  1007.                 45
  1008.  
  1009. FIGURE 8.4:A COLOR MAP SHOWING A DEVEASE IN CONTRAST.
  1010.  
  1011. levels)are mapped to output intensities 128 and 144(a differnece of only 16
  1012. intensity levels). Notice that the difference between two input intensities has
  1013. been reduced. This produces a commensurate decrease in visible contrast.
  1014. Notice,again,that contrast loses some amount of visual detail just as the
  1015. brightness adjustment. Specifically,you note that in the color map shown in
  1016. Figure 8.4 input intensities which could have ranged from 0 to 255 are now
  1017. restricted to the range of 64 to 192. This may or may not be acceptable for any
  1018. given image.
  1019. The contrast control in ADPro ranges from -50 to 50 with 0 being the neutral
  1020. value. Setting the contrast control to a positive value uniformly pivots the
  1021. color map around its center in counter-clockwise direction(toward the vertical)
  1022. which increases visible contrast.
  1023.  
  1024.                 46
  1025.  
  1026. 8.1.3 GAMMA
  1027. The gamma adjustment provides a way to significantly brighten an image without
  1028. losing much detail. It does this by introducing a curve into the color map
  1029. whereby the color map is shifted upwards(made brighter)but no portion of the
  1030. color map gets clipped to the maximum or minimum values.
  1031. Figure 8.5 shows an example color map which has a gamma adjustment. Notice that
  1032. the two input intensities,128 and 160 are output as intensities 192 and 216.
  1033. They are,therefore,brighter.
  1034. The gamma adjustment also effects the contrast of the image. In the darker part
  1035. of the spectrum,contrast is increased. However,in the lighter part of the
  1036. spectrum,contrast is decreased.
  1037. The gamma control in ADPro ranges from 0 to 100 where 0 represents no gamma
  1038. adjustments. The overall effect of the gamma adjustment is usually quite
  1039. satisfactory and we recommend its libral use.
  1040.  
  1041. 8.1.4 RED,GREEN AND BLUE ADJUSTMENTS
  1042. In addition to the previously described methods of color adjustments,ADPro also
  1043. offers control over the individual brightness of the red,green,and blue data.
  1044. Gray scale brightness is directly controled by the main brightness control so
  1045. no additional control is necessary.
  1046. Having this individual control allows for simple global color balancing
  1047. changes. For example,an image which has far too much red can be balanced by
  1048.  
  1049.                 47
  1050.  
  1051. FIGURE 8.5:A COLOR MAP SHOWING AN EXAMPLE OF GAMMA CORRECTION.
  1052.  
  1053. decreasing the global brightness of all of the red data in the image.
  1054. Note that the individual brightness controls suffer from the same drawback as
  1055. the main brightness control. That is,the more heavily they are used,the more
  1056. detail will be lost due to the color map being clipped against its minimum and
  1057. maximum values.
  1058. The red,green,and blue adjustments in ADPro all range from -50 to 50 with 0
  1059. being the neutral value.
  1060.  
  1061. 8.1.5 ABOUT THE BALANCING CONTROL PANEL
  1062. The panel which appears when you select the balance button(shown in Figure 8.6)
  1063. contains the 6 color adjustments described above. Each is laid out as a
  1064. horizontal sliding gadget. You can use the left mouse button to select anywhere
  1065.  
  1066.                 48
  1067.  
  1068. FIGURE 8.6:THE BALANCE CONTROL PANEL.
  1069.  
  1070. within each gadget to change that gadget's value.
  1071. You can also use the left mouse button to select the "knob" within a gadget and
  1072. drag it to a new position. As you drag the knob,the value of the gadget will be
  1073. updated in real-time in the integer gadget immediately to the right of the
  1074. slider.
  1075. If you prefer to directly type in the value of any one of the color controls,
  1076. simply click the left mouse button within the integer gadget to the right of
  1077. the desired control. Be sure to press the return key after entering a new
  1078. value.
  1079. At the bottom of the panel you'll find three buttons which will either accept,
  1080. reset,or cancel any of the changes you've made to the color controls.
  1081. Additionally,depressing either SHIFT-RETURN or ALT-RETURN from the keyboard
  1082.  
  1083.                 49
  1084.  
  1085. will also accept any new values entered into the control panel.
  1086.  
  1087. 8.1.6 SAVING AND LOADING BALANCE SETTINGS
  1088. Whenever raw image data is saved in the IFF format,ADPro will include the
  1089. current locations of each of the balance settings. The positions of each
  1090. balance setting will be restored whenever an 8 or 24 bit-plane IFf file is
  1091. loaded which contains stored settings.
  1092. The saving and restoring of the positions of the balance settings are not
  1093. supported in any other format other than the IFF format. However,the effect of
  1094. the balance settings will be preserved whenever raw image data is saved
  1095. regardless of format.
  1096. After loading a raw image(an image which is not color mapped),you may be
  1097. presented with a panel which states that the "current balance settings do not
  1098. correspond to actual data" when attempting to enter the balancing control
  1099. panel. This means that the image which was loaded did not contain ADPro
  1100. specific information about where to place the knobs in the balancing control
  1101. panel.
  1102. If the loaded data contained a color look-up table(such as in some TIFF images)
  1103. that color look-up table will be loaded and effective until balance settings
  1104. are "accepted". So,should you wish to use the color look-up table actually
  1105. contained in a raw image,do not perform an "accept" in the balancing control
  1106. panel. If you should enter the balancing control panel,depress "cancel" to
  1107. preserve the color look-up table loaded from the file.
  1108.  
  1109.                 50
  1110.  
  1111. "Accepting" a set of balancing controls has the effect of completely
  1112. overwritting any color look-up table which might have been loaded with image
  1113. data.
  1114.  
  1115. 8.2 DITHERING
  1116. Dithering is a technique for achieving greater color fidelity at the expense of
  1117. spatial fidelity(image sharpness). ADPro supports six dithering types. These
  1118. are:none,Floyd-Steinberg,Burkes,Sierra,Jarvis,Stucki,and Random dithers.
  1119. With the exception of the random dither,the dithers are presented in the order
  1120. of greatest to least effect on the image. However,counter to intuition,they
  1121. range from fastest to slowest.
  1122. Floyd-Steinberg(1)is the tightest of the dithers and produces good results for
  1123. all video modes. The Stucki(5)dither is the sparest(and most time consuming to
  1124. compute)and produces good results where just a little dithering is desired.
  1125. Dithers 1 through 5 are each "error diffusion" dithers. The added computation
  1126. time of the higher numbered dithers results from incorporating a greater number
  1127. of pixels into each dithering computation. This also accounts for why the
  1128. higher numbered dithers affect the image less. That is,the error diffusion is
  1129. spread over a larger number of pixels(thus affecting each pixel less).
  1130. The random dither is useful in the preparation of successive images which will
  1131. become part of an animation. While the other dithering techniques produce
  1132. superior results,they may also produce an undesired flickering when multiple
  1133. images are animated. The random dither does not have this problem when
  1134.  
  1135.                 51
  1136.  
  1137. animating.
  1138. After selecting the dithering style of your choice,and any other modifications
  1139. to the image using ADPro's other image processing capabilities,select the
  1140. execute button(located in the lower right hand corner of the screen)to render
  1141. the image.
  1142. The sequence of dithers which will be successively displayed in the dither
  1143. button is quite lengthy. As a convenience,the dither button is logically
  1144. divided into two halves. If you click on the left half of the button,the order
  1145. in which it sequences through the dithers will be the opposite of that which is
  1146. displayed if you click upon the right half of the button.
  1147. Thus,if you suceessively click on the right half of the button but accidentally
  1148. advance too far,click on the left half of the button to quickly return to the
  1149. dither you want.
  1150. Dithering is applied during rendering and has no effect on the raw 8 bit-plane
  1151. gray scale data or 24 bit-plane color data. Therefore,you may change and
  1152. rechange the dithering setting at will without affecting the original data.
  1153. Dithering gives its best results when displayed in the high resolution video
  1154. modes. Dithering provides a benefit in the HAM modes but can slightly increase
  1155. the amount of HAM fringing present in the rendered image. Of the dithering
  1156. choices available,the random dither is the least likely to introduce HAM
  1157. fringing. Dithering is not recommended in the A-RES modes.
  1158.  
  1159.                 52
  1160.  
  1161. 8.3 PALETTE
  1162. ADPro provides very flexible and powerful palette controls. The palette control
  1163. panel is shown in Figure 8.7 and is described in this section. We'd like to
  1164. mention that because the palette controls are so flexible and powerful,we
  1165. cannot envision all the different effects and uses they may have. This section
  1166. will describe the basic operation of the palette controls. We encourage you to
  1167. experiment with the palette controls to discover new uses.
  1168.  
  1169. 8.3.1 WHEN ARE THE PALETTE CONTROLS USED?
  1170. In general,the palette controls are used in the rendering calculation only when
  1171. the number of colors button(one of the screen controls)is set to CUST.
  1172. If this button is not set to CUST,changes to the palette controls will not be
  1173. honored except for the palette's status and depth.
  1174. As described in the next section,a palette's status can be Locked or Unlocked.
  1175. When locked,the palette is "write-protected" which means that ADPro's own color
  1176. picking tenchology is disabled. The effect of a Locked palette is in force
  1177. regardless of the setting of the number of color button.
  1178. As described in section 8.3.3,when ADPro selects colors,it can do so at two
  1179. levels of accuracy. For typical applications,an accuracy of 12 bits is
  1180. appropriate. However,some applications such as creating imagery for display on
  1181.  
  1182.                 53
  1183.  
  1184. FIGURE 8.7: THE PALETTE CONTROL PANEL
  1185.  
  1186. non-Amiga computers,may benefit from the ability to choose colors at a 15 bit
  1187. accuracy. The palette depth selection is in force any time ADPro selects a
  1188. color on its own.
  1189.  
  1190. 8.3.2 PALETTE STATUS
  1191. The palette status button can be set to one of two values:Locked and Unlocked.
  1192. This defines whether or not ADPro will execute its color choosing routines
  1193. prior to rendering or will skip directly to rendering using the pre-existing
  1194. palette contents.
  1195. When the palette is Unlocked,ADPro will analyze the raw image data and
  1196. catalogue various statistics about the colors it contains. It will then
  1197. optimally choose a set of colors which best approximates the entire image.
  1198. When the palette is Locked,ADPro will use the prior contents of the palette and
  1199. will not choose a new one.
  1200.  
  1201.                 54
  1202.  
  1203. Each pixel in the image will be rendered in the color chosen from the palette
  1204. which best matches the intended color.
  1205. Referring to Figure 8.1,you can see that color adjustments and dithering still
  1206. affect the final image even when the palette is Locked.
  1207. The palette Locked condition can also affect image loading. If the palette is
  1208. in the Locked state and the image you wish to load contains a palette,ADPro
  1209. will ask you if you wish to load the palette from the file or keep the
  1210. previously defined palette. This will occur whether or not the number of colors
  1211. button is set to CUST.
  1212.  
  1213. 8.3.3 PALETTE ACCURACY
  1214. When ADPro selects colors,it can do so at two levels of accuracy. Typically,the
  1215. standard palette accuracy is sufficient for nearly all imagery intended for use
  1216. on an Amiga based computer.
  1217. Other computer systems or display technologies can take advantage of more
  1218. accurate color palettes. For example,VGA systems can display up to 256 colors
  1219. simultaneously chosen from an 18 bit-wide palette. Commodore's Hi-Res graphics
  1220. card can display up to 256 colors chosen from a palette 24 bits wide.
  1221. Consider the difference between a palette's depth and its width(accuracy).
  1222. Palette depth can be thought of as the number of colors which can be
  1223. simultaneously displayed. In the case of VGA,this is 8 bits deep(256 colors).
  1224. The width of the palette can be though of as the precision with which each
  1225. color can be chosen. In the case of VGA,this is 18 bits wide.
  1226.  
  1227.                 55
  1228.  
  1229. A 32 color image can be displayed on both the Amiga's own screen and on
  1230. Commodore's A2410 Hi-Res graphics card. For display on the Amiga's own screen,
  1231. the 32 colors are chosen from a total spectrum of 4096 choices. For display on
  1232. Commodore's Hi-Res graphics card,the 32 colors can be chosen from a spectrum of
  1233. 16.7 million choices.
  1234. By offering selectable palette accuracy,ADPro makes it possible to prepare high
  1235. quality imagery for nearly any computer display hardware. The enhanced palette
  1236. mode,while taking longer to computer,provides exceedingly smooth shading for
  1237. images to be displayed on non-Amiga standard display devices.
  1238. In the enhanced palette mode,renderings in Amiga specific formats such as HAM,
  1239. EHB and the ARES modes are not supported. The enhanced palette can slightly
  1240. improve 2 through 32 color renderings which are displayable on the Amiga.
  1241. However,this benefit may not be noticeable enough to warrant the extra
  1242. computation time.
  1243.  
  1244. 8.3.4 COLORS(TOTAL)
  1245. If you set the number of colors button to CUST,the total colors button takes
  1246. over the function of the number of colors button in deciding what format the
  1247. image will be rendered in. The choices include:2,4,8,16,128,and 256 colors,as
  1248. well as EHB and HAM.
  1249. The choice you make here determines how many colors can occupy the image's
  1250. palette. Therefore,the total colors button directly effects the colors used and
  1251. offset color zero values.
  1252.  
  1253.                 56
  1254.  
  1255. 8.3.5 COLORS(USED)
  1256. The colors used gadget allows you to enter a number which ranges from 2 to the
  1257. total number of colors chosen. Normally,the number of colors used would be set
  1258. to the maximum number possible for a given screen format. However,there are
  1259. many situations where it is necessary to render in fewer colors than the screen
  1260. format will permit.
  1261. For example,Amiga based genlocks show full color video through regions of the
  1262. screen which are set to color 0. If a bit map were to be rendered including
  1263. color 0 and then genlocked,bits of genlocked video would poke through the bit
  1264. map anywhere a pixel with color 0 is found.
  1265. To create an image which will appear solid when used with a genlock,simply
  1266. don't use color 0 anywhere in the image. This can be accomplished by
  1267. instructing ADPro to use one fewer color than is available. Then specify a
  1268. value of 1 in the offset color zero gadget. This will instruct ADPro to start
  1269. filling in colors starting at color 1 rather than at 0. The result will be an
  1270. image which contains n - 1(where n is the total number of colors possible)
  1271. colors starting at color 1.
  1272. As another example,suppose you are reuired to use a specific 16 color palette
  1273. and have to render an image with 4 colors(but in 4 rather than 2 bit-planes).
  1274. This sort of example is a common requirement for animators. To do this,load and
  1275. lock the required palette. Select a total number of colors of 16 but a number
  1276. of colors to be used as 4. Specify a value in offset color zero which will
  1277. offset the colors used to the first of the 4 colors you wish to use. Note that
  1278. this requires the 4 colors you wish to use to be stored contiguously in the
  1279.  
  1280.                 57
  1281.  
  1282. palette.
  1283. The number of colors used cannot exceed the total number of colors. Also,the
  1284. sum of colors used and offset color zero cannot exceed the total number of
  1285. colors.
  1286.  
  1287. 8.3.6 OFFSET COLOR ZERO
  1288. The value in the offset color zero gadget is interpreted in different ways at
  1289. different times. For example:
  1290. When rendering and the palette is Unlocked,offset color zero defines where in
  1291. the palette ADPro will begin its choosing of new colors. For example,if offset
  1292. color zero is set to 4,colors 0 through 3 will not be changed and ADPro will
  1293. start choosing new colors beginning at color 4.
  1294. When rendering and the palette is Locked,offset color zero defines where in the
  1295. palette ADPro begins fetching colors for the rendering calculation. For
  1296. example,if you wanted ro render a 16 color screen with only 15 colors,you can
  1297. either render with the first 15 colors or the last 15 colors. Setting offset
  1298. color zero to 0 will render with the first 15 colors while setting offset color
  1299. zero to 1 will render with the last 15 colors.
  1300. When loading a color palette,offset color zero defines where in the palette
  1301. ADPro will begin storing the loaded values. For example,to create a 16 color
  1302.  
  1303.                 58
  1304.  
  1305. palette from two 8 color palettes,load the first 8 color palette with offset
  1306. color zero set to 0. Load the second 8 color palette with offset color zero set
  1307. to 8. Then,lock the palette,and you're ready to render.
  1308. The value in offset color zero can be in the range of 0 to the total number of
  1309. colors minus 2. Also,the sum of colors used and offset color zero cannot exceed
  1310. the total number of colors.
  1311.  
  1312. 8.3.7 SORT DIRECTION
  1313. When ADPro chooses colors and places them into the palette,it can sort them by
  1314. increasing or decreasing brightness. Thus button is a toggle which controls the
  1315. sort direction. Of particular note is that color 0 is the color which will be
  1316. shown as a border around non-overscanned images. In general,you'd like this to
  1317. be as dark as possible(Darkest To Lightest)so as not to be distracting.
  1318. However,this can be overridden by selecting Lightest To Darkest.
  1319.  
  1320. 8.3.8 EDIT
  1321. Selecting the Edit button will bring up a standard color requester.
  1322. You may manipulate one color at a time,chosen by clicking the left mouse button
  1323. over one of the colored boxes at the right hand top of the color requester.
  1324. These boxes represent the colors contained in each color register. The number
  1325. of boxes displayed will correspond to the number of user definable colors in
  1326.  
  1327.                 59
  1328.  
  1329. the screen mode you have selected in the number of colors button.
  1330. The color which you have chosen to manipulate will be rendered in a rectangular
  1331. area in the left hand top of the color requester.
  1332. Along the left hand edge of the color requester,three sliding gadgets can be
  1333. found which correspond to the red,green,and blue composition of the color being
  1334. modified.
  1335. Below the color boxes(at the right middle of the color requester)are four
  1336. command gadgets. These are:
  1337. Copy - After selecting the Copy command,the current color values will be copied
  1338. to the next color register you click the left mouse button in. This will cause
  1339. the two color registers to have the same value. 
  1340. The current color register will become the register you copied to.
  1341. Swap - After selecting the Swap command the contents of the current color
  1342. register will be swapped with the contents of the next color register you
  1343. select with the left mouse button.
  1344. The current color register will become the register you swapped to.
  1345. Undo - After selecting the Undo command the previous Swap,Copy or Spread
  1346. command will be undone.
  1347. The current register is unchanged.
  1348.  
  1349.                 60
  1350.  
  1351. Spread - After selecting a color register to begin spreading from,select the
  1352. Spread command with your left mouse button. Then select another color register
  1353. to spread to.
  1354. The color registers you select become end points. Any color registers in
  1355. between them are changed to a color in between the two end points.
  1356. After editing,the effect of the new palette is immediately viewable by
  1357. selecting the redisplay button in the commands area. However,the image which
  1358. will be displayed will simply be the previously rendered image with a new set
  1359. of colors. To rerender the image(that is,go through the entire data flow as
  1360. shown in Figure 8.1)you can select the execute button.
  1361. Editing the palette is not permitted while in the enhanced palette mode.
  1362.  
  1363. 8.3.9 LOAD
  1364. Selecting the load button causes the file requester to appear. Using it,you can
  1365. select a file from which ADPro will attempt to read a palette. All Amiga format
  1366. images such as 2,4,8,and 16 color images have color palettes. However,raw image
  1367. data such as 18,21 or 24 bit-plane files do not. Palettes can also be loaded
  1368. from IFF "brush" files as well.
  1369. Palette loading is affected by several other factors in the palette control
  1370. panel. Specifically,if the number of colors in the palette to be loaded exceeds
  1371. the number of colors available to be loaded into,the excss colors will be
  1372. ignored.
  1373.  
  1374.                 61
  1375.  
  1376. For example,if the total number of colors permissable at the time load is
  1377. selected(as defined by the value in the colors used button)is 15,and the
  1378. palette to be loaded contains 32 colors,no more than the first 15 will be
  1379. loaded.
  1380. In fact,if the value in offset color zero is non-zero at the time load is
  1381. selected,then the number of colors which will be loaded(in the example cited in
  1382. the previous paragraph)will be lower than 16.
  1383. Note that a loaded palette will be overwritten if the palette is not in a
  1384. Locked condition and you select the execute button to render an image.
  1385.  
  1386. 8.3.10 SAVE
  1387. The currently defined palette can be saved to a file by selecting the save
  1388. button. Upondoing so,the file requester will appear. After selecting a file
  1389. name,the palette will be stored to disk.
  1390. Note that the saved file will contain only a palette. It will not contain any
  1391. image data. Therefore,use caution when selecting a pre-existing file to store
  1392. the palette,as that file will be overwritten with palette information. Its
  1393. previous contents will be lost.
  1394.  
  1395. 8.3.11 GET WB
  1396. This command is very useful for creating imagery which will be displayed on the
  1397. Amiga WorkBench. Selecting this command will cause ADPro to load the currently
  1398. defined WorkBench colors into the palette starting at the color defined by
  1399. offset color zero.
  1400.  
  1401.                 62
  1402.  
  1403. This command fetches the up to four colors found in the Preferences structure.
  1404. Operating system 2.0 allows the WorkBench to contain more than four colors.
  1405. However,these colors are not found in the Preferences structure as defined by
  1406. earlier versions of the operating system.
  1407. Therefore,consider the GETWB command as a short hand for loading only the first
  1408. four colors of the WorkBench. Should you require access to the palette of a
  1409. more than four colored WorkBench(possible only under Version 2.0 or later),use
  1410. the palette loading facility to load a palette from ENV:SYS/PALETTE.
  1411.  
  1412.                 63
  1413.  
  1414.             CHAPTER 9 - SCREEN CONTROLS
  1415.  
  1416. ADPro's screen controls offer a selection of 208 possible video modes,as many
  1417. or more than any other Amiga program at this time. Once an image has been fully
  1418. rendered,many of the changes from one screen mode to another are instantaneous.
  1419. Note that changes to any of the screen controls do not affect the raw or
  1420. rendered data in any way. Therefore,such changes can be quickly undone.
  1421.  
  1422. 9.1 HORIZONTAL SIZE
  1423. The various horizontal sizes are shown in Table 9.1. Note that some color modes
  1424. preclude some horizontal sizes. These limitations are shown in Table 9.3.
  1425. Given a fully rendered image,changes from low resolution to high resolution
  1426. will be instantaneous if the color mode chosen is allowed in both low and high
  1427. resolution.
  1428.  
  1429.                 64
  1430.  
  1431.         MODE                WIDTH
  1432.         Low Res                320
  1433.         Low Res/OverScan        368
  1434.         Hi Res                640
  1435.         Hi Res/OverScan            736
  1436.  
  1437. TABLE 9.1: THE HORIZONTAL RESOLUTIONS SUPPORTED BY ADPRO.
  1438.  
  1439. 9.2 VERTICAL SIZE
  1440. The various vertical sizes are shown in Table 9.2. All color modes are
  1441. supported in all vertical sizes. Selecting an NTSC vertical size on a PAL
  1442. machine simply truncates the screen size at the NTSC lower boundary. Selecting
  1443. a PAL vertical size on an NTSC machine simply extends the screen size below the
  1444. visible lower border of your NTSC screen.
  1445. Given a fully rendered image,changes from one vertical size to another are
  1446. instantaneous. Aspect correction for changing between interlaced and non-
  1447. interlaced screens can be accomplished using the digital scaling capability of
  1448. ADPro.
  1449.  
  1450. 9.3 NUMBER OF COLORS
  1451. The various choices of color mode are given in Table 9.3. This table also
  1452. indicates the restrictions that the choice of color mode places on the
  1453. horizontal size.
  1454. The color mode is selected using the number of colors button. Since the number
  1455. of choices for this button is large,the order in which the choices are selected
  1456.  
  1457.                 65
  1458.  
  1459. MODE                    HEIGHT
  1460. NTSC                    200
  1461. NTSC/OVERSCAN                240
  1462. NTSC/LACED                400
  1463. NTSC/LACED/OVERSCAN            480
  1464. PAL                    256
  1465. PAL/OVERSCAN                296
  1466. PAL/LACED                512
  1467. PAL/LACED/OVERSCAN            592
  1468.  
  1469. TABLE 9.2: THE VERTICAL RESOLUTIONS SUPPORTED BY ADPRO.
  1470.  
  1471. SETTING        COLORS    BITPLANES    LOW RES        HI RES
  1472. 2        2    1        Y        Y
  1473. 4        4    5        Y        Y
  1474. 8        8    3        Y        Y
  1475. 16        16    4        Y        Y
  1476. 32        32    5        Y        N
  1477. 64        64    6        N        N
  1478. 128        128    7        N        N
  1479. 256        256    8        N        N
  1480. EHB        64    6        Y        N
  1481. HAM        4096    6        Y        N
  1482. AHAM        4096    6        Y        N
  1483. ARZ0        4096    4        N        Y
  1484. ARZ1        4096    4        N        Y
  1485.  
  1486. TABLE 9.3: COLOR MODES AND OTHER INFORMATION.
  1487.  
  1488.                 66
  1489.  
  1490. can be reversed. Clicking on the right half of the button sequences through the
  1491. list in ascending order while clicking on the left half of the button sequences
  1492. through the list in the opposite order.
  1493. Notice that some entries in Table 9.3 indicate that that particular mode will
  1494. not work in either low or high resolution Amiga screen modes. This indicates a
  1495. number of colors which is not supported by the Amiga's own display
  1496. capabilities. When rendering an image in 64 to 256 colors,no image will be
  1497. displayable on the Amiga's screen. Rendered image data is still available,
  1498. however,for display on non-standard display devices such as the Commodore A2410
  1499. Hi-Res graphics card or for saving using a Saver which supports that particular
  1500. number of colors.
  1501. For a detailed description of the CUST setting,please see sections 8.3.1 and
  1502. 8.3.4.
  1503.  
  1504. 9.4 WHAT ARE A-RES AND A-HAM?
  1505. The A-HAM data format is a variation on Sliced HAM(SHAM)popularized by Rhett
  1506. Anderson formerly of Compute Magazine. In A-HAM,a new set of 16 base color
  1507. registers is chosen for each line in the image. This increases the color
  1508. fidelity of a HAM image at the expense of increased machine and display
  1509. overhead.
  1510. Rendering an A-HAM from image data which contained fewer than 4096 colors to
  1511. start with will probably not produce any better results than a normal HAM
  1512. rendering.
  1513.  
  1514.                 67
  1515.  
  1516. ADPro will read and write A-HAM images in the same file format(as registered
  1517. with Commodore Amiga Technical Support)used by Newtek's Dynamic HAM image
  1518. files.
  1519. The A-RES modes are 16 color hi-res variants developed by ASDG Incorporated.
  1520. The A-RES file format was designed to be backwards compatible with Newtek's
  1521. Dynamic Hi-Res format as registed with Commodore Amiga Technical Support.
  1522. A-RES allows all 4096 colors supported by the Amiga to be present on one hi-res
  1523. screen at the expense of extreme processor overhead while an A-RES image is
  1524. being displayed.
  1525. Do not think the A-RES modes are as general purpose as the standard Amiga
  1526. display modes. There are many limitations to what can be done while displaying
  1527. an A-RES image and not all images lend themselves to rendering in this mode. As
  1528. such,think of A-RES as a tool which can only sometimes prove useful.
  1529. A-RES images can be generated in one of two variations.
  1530. ARZ0 allows all 16 color registers to change on each line. The advantage of
  1531. ARZ0 is that it is the better looking of the two A-RES variants. The down-side
  1532. of ARZ0 is that changes in color register 0 will be visible in the border of
  1533. non-horizontally overscanned images.
  1534. ARZ1 allows at most 15 color registers to change from line to line and always
  1535. clamps color register to 0 to black. This advantage of ARZ1 is that non-
  1536. overscanned images have a solid black border. The disadvantage is that ARZ1
  1537. images make use of one less color register than ARZ0 images. This may make some
  1538.  
  1539.                 68
  1540.  
  1541. images appear less attractive than the same image rendered in ARZ0.
  1542. Images displayed in the A-RES or A-HAM modes cannot be scrolled or used with
  1543. MicroIllusions' Transport Controller. Also,after displaying an A-RES or A-HAM
  1544. image,ADPro will cause each of your floppy drives to be re-examined for the
  1545. possibility of disk changes. The drive gronking you hear is normal.
  1546. A-RES and A-HAM are compatible with the Amiga 3000 when running version 2.02 of
  1547. the operating system or later.
  1548.  
  1549. 9.5 OTHER OVERSCAN SIZES
  1550. Tables 9.1 and 9.2 provide the dimensions of the overscan screens directly
  1551. supported by ADPro. These values were suggested by the hardware documentation
  1552. provided by Commodore. However,the Amiga can produce horizontal and vertical
  1553. overscans larger than the values directly supported by ADPro.
  1554. If you wish to produce an image conforming to a different overscan size,simply
  1555. render the image to the desired size(since ADPro will render at any size)and
  1556. use a program other than ADPro for display purposes.
  1557.  
  1558.                 69
  1559.  
  1560.             CHAPTER 10 - OTHER COMMANDS
  1561.  
  1562. 10.1 ABOUT
  1563. Selecting this command(by depressing the HELP key)will display credits due to
  1564. the authors of ADPro as well as the ADPro program's version ID.
  1565.  
  1566. 10.2 SAVE
  1567. Please refer to Chapter 6 for general information about how to save images with
  1568. ADPro. Please refer to Part 3 for specific information about individual savers.
  1569.  
  1570. 10.3 REDISPLAY
  1571. Selecting the redisplay button will cause any Amiga compatible rendered image
  1572. data to be displayed. No image will be displayed if there is no rendered image
  1573.  
  1574.                 70
  1575.  
  1576. data available,or the available rendered image data is not in an Amiga
  1577. compatible format.
  1578. If you have made any changes to the color or screen controls and not hit the
  1579. execute button,the image displayed after selecting redisplay will not show the
  1580. effect of any of these changes.
  1581. In all modes except the A-HAM and A-RES modes you can scroll about the image
  1582. using the four arrow keys(provided that the image is larger than the screen).
  1583. To return to the ADPro control screen,simply click the left mouse button
  1584. anywhere in the image.
  1585.  
  1586. 10.4 ORIENTATION
  1587. The orientation button is described more fully in the chapter entitled Loading
  1588. An Image. To summarize that information,the orientation button toggles between
  1589. a portrait and landscape setting. The state of this button influences which
  1590. orientation the next image to be loaded will have. Using this feature in
  1591. conjunction with horizontal and vertical flips can produce 90 degree rotations
  1592. through 0,90,180,270 degrees.
  1593.  
  1594. 10.5 LOAD
  1595. Aspects of the load function are described more fully in Chapter 5. To
  1596. summarize that information,the load function in ADPro is actually implemented
  1597. in separate programs called Loaders. All Loaders must be placed in a specific
  1598. directory for ADPro to be able to find them.
  1599.  
  1600.                 71
  1601.  
  1602. A specific Loader is selected by toggling the Load Format button until the
  1603. desired format is displayed. Then,select the load button. This will actually
  1604. cause the selected Loader to begin running. The Loader may request some
  1605. additional information from you before actually displaying the file requester
  1606. one or more times.
  1607. Each file to be loaded is searched for a color map. If a color map is contained
  1608. in the file,it will be loaded along with the image data provided that the ADPro
  1609. palette is not in a Locked state. If the palette is Locked,ADPro will
  1610. ultimately ask you if you really do wish to load the palette from the file.
  1611. If found,the palette will be inspected to see if it contains only shades of
  1612. gray. If it does,the file's data will be expanded out into an 8 bit-plane gray
  1613. scale image. If not,the file will be expanded out into a 24 bit-plane color
  1614. image.
  1615. Depending upon the state of the orientation button,the image may be rotated 270
  1616. degrees while it is being read from disk.
  1617. The expansion into 8 or 24 bit-planes is usually performed after the file has
  1618. been loaded. However,if you are loading an Amiga displayable file and there
  1619. isn't enough memory to hold the displayable data,then it will be loaded without
  1620. the conversion to 8 or 24 bit-planes. In this case,the image can be displayed
  1621. but none of the processing commands which depend on having raw data around will
  1622. function.
  1623. When loading files which are already in an Amiga displayable format,the image
  1624. is directly viewable immediately after loading by selecting the redisplay
  1625. command.
  1626.  
  1627.                 72
  1628.  
  1629. Depending on the load format,aborting a load while in progress may or may not
  1630. produce displayable image data.
  1631.  
  1632. 10.6 EXIT
  1633. Selecting the exit button will cause ADPro to exit.
  1634.  
  1635. 10.7 SEPARATE
  1636. Selecting the separate button brings up ADPro's color separation control panel
  1637. shown in Figure 10.1. Color separation is the process of turning red,green,and
  1638. blue data appropriate for computer display into cyan,yellow,magenta and usually
  1639. black data appropriate for print publication.
  1640. In order to color separate,raw color data must be available in memory.
  1641. ADPro supports 3 different types of color separations. These are:
  1642. RGB separations allow you to split the current color image into its component
  1643. red,green and blue planes. Each selected plan will be written to a separate
  1644. file.
  1645. Three color separations convert the current color image into cyan,yellow,and
  1646. megenta planes without provisions for a black plane. Three color separations
  1647. are sometimes less expensive to bring to press but will not produce true gray
  1648. tones which might be part of the image.
  1649.  
  1650.                 73
  1651.  
  1652. FIGURE 10.1:THE SEPARATION CONTROL PANEL
  1653.  
  1654. Four color separations convert the current color image into cyan,yellow,
  1655. magenta,and black planes. Four color separations are what are generally used in
  1656. the printing industry today.
  1657. Each of these different types of separations can be performed with an accuracy
  1658. of 24 bit-planes or 12 bit-planes. A 24 bit-plane color separation can
  1659. represent more than 16 million colors while a 12 bit-plane separation can
  1660. represent only 4096 different colors.
  1661. The disadvantage of 24 bit-plane separations is that they can be quite large
  1662. (however,12 bit-plane separations can be quite large as well). The disadvantage
  1663. of 12 bit-plane separations is that they can represent so few colors.
  1664. The choice of which to use(12 or 24 bit-planes)can depend upon many things.
  1665. Such as:
  1666.  
  1667.                 74
  1668.  
  1669. 1. If your original image was an Amiga displayable format,the 24 bit-plane
  1670. color data contains only 4096 colors(however,using ADPro's scaling feature to
  1671. reduce the size of the image will introduce additional colors to better blend
  1672. the image). Therefore,you may not get any additional benefit from a 24 bit-
  1673. plane separation.
  1674. 2. If your image contains many similar hues,such as the slowly changing colors
  1675. in the human face in sunlight,then you may benefit from the dramatically
  1676. greater dynamic range of a 24 bit separation. For example,a GIF image with 256
  1677. colors may contain a large number of shades of flesh tone. A 12 bit-plane
  1678. separation can only represent at most 16 similar shades while a 24 bit
  1679. separation can represent at most 16 similar shades while a 24 bit separation
  1680. can represent at most 256 similar shades.
  1681. 3. If you plan on using a standard Amiga printer driver and program to output
  1682. the separations,chances are that the program you will use will not be able to
  1683. deal with the files a 24 bit-plane separation would produce. However,if you
  1684. plan on outputing your separation to a PostScript device,you may use either the
  1685. 12 or 24 bit-plane separations.
  1686. Each plane of a 24 bit-plane separation contains 8 bitplanes. Each plane of a
  1687. 12 bit-plane separation contains 4 bit-planes. You select between the two
  1688. settings by clicking on the depth button.
  1689. Using the type button you can select from among the three types of separation
  1690. that ADPro supports.
  1691. Within each type,you can select all possible planes or any one single plane by
  1692. toggling the plane button.
  1693.  
  1694.                 75
  1695.  
  1696. When doing a four color(CYMK)separation,you can control the amount of UCR and
  1697. GCR ADPro will perform. UCR or "Under Color Removal" defines what percentage of
  1698. color will be removed in order to compensate for the addition of the black
  1699. plane. GCR or "Gray Component Replacement" defines what percentage of the color
  1700. removed will be added back in as black.
  1701. A four color separation with 0 percent UCR reverts back into a three color
  1702. separation(i.e.:there's no accomodation made for black). A four color
  1703. separation made with 100 percent UCR will produce a color shifted image very
  1704. similar in quality to early color photography.
  1705. In addition to UCR and GCR controls,ADPro also offers the user complete control
  1706. over its ink compensation function. Printer's inks are not completely pure
  1707. materials. For example,there is some amount of yellow mixed into the magenta
  1708. ink. And,there is some amount of magenta which unavoidably is found in the cyan
  1709. ink. The ink compensation values will correct for these impurities.
  1710. In general,leave the ink compensation values alone for best results. The ink
  1711. compensation function can be completely disabled by turing it "off". You will
  1712. notice that without ADPro's ink compensation function,a blue sky will print as
  1713. purple. With the ink compensation function set at its default settings,blue
  1714. skies are blue again.
  1715. When entereing UCR/GCR or ink compensation values from the keyboard,the RETURN
  1716. key toggles between UCR and GCR (when either of these two gadgets is active)or
  1717. between the Yellow and Magenta compensations(when either of these two gadgets
  1718. is active). ALT-RETURN can be used to toggle between the pairs.
  1719.  
  1720.                 76
  1721.  
  1722. 10.7.1 USING ADPRO SEPARATIONS WITH PROFESSIONAL PAGE
  1723. Gold Disk's Professional Page(versions prior to 2.0)cannot manipulate images
  1724. with a higher color resolution than the Amiga currently supports(12 bit-planes
  1725. or 4096 colors). ASDG developed a program called ReSEP that allows 24 bit-plane
  1726. separations created by Professional ScanLab or The Art Department to be merged
  1727. with documents created in Professional Page.
  1728. Although the method is slightly circuitous,it works beautifully. Given below is
  1729. the basic flow of operations:
  1730. 1. In ADPro,perform any adjustments to the image you wish to make(for example
  1731. any color balancing or changes in contrast).
  1732. 2. Render the image in an any Amiga displayable format and save this rendering
  1733. to disk. In the steps that follow,we'll refer to this file as the "Amiga
  1734. displayable" version.
  1735. 3. Execute a color separation of the same image data and save this to disk.
  1736. 4. In Professional Page,construct the page as you wish placing text and image
  1737. boxes where you wish them to go. Load the Amiga displayable version of the
  1738. image(from the steps above)and place this image anywhere on the page as you
  1739. would with any other Professional Page image box.
  1740. You can scale,crop,or cover up this image in any way that you could with any
  1741. other image box.
  1742.  
  1743.                 77
  1744.  
  1745. 5. Execute a color separation from Professional Page,but save the results to
  1746. disk.
  1747. 6. In ReSEP,load the PostScript file generated in the previous step by
  1748. Professional Page. ReSEP will identify all of the image boxes on the page.
  1749. ReSEP will identify all of the image boxes on the page. Using ReSEP select the
  1750. ADPro separated files to replace the Amiga displayable version of the same
  1751. image.
  1752. When done,press the Process button. The output of ReSEP is a second PostScript
  1753. file identical to the first except that the selected images have had their 12
  1754. bit separations replaced with 24 bit separations.
  1755.  
  1756. 10.8 EXECUTE
  1757. Select the execute button in order to cause any changes you might have made in
  1758. the screen,color,or image controls areas to be put into effect.
  1759. If the only change you've made is a change of screen width or height,selecting
  1760. execute will usually cause an image to render instantaneously.
  1761.  
  1762.                 78
  1763.  
  1764.             CHAPTER 11 - THE FILE REQUESTER
  1765.  
  1766. Anytime you save or load a file,ADPro invokes its file requester. This chapter
  1767. describes how to use the file requester to specify the names of files to be
  1768. saved or loaded. An example of the file requester is given in Figure 11.1.
  1769.  
  1770. 11.1 WHY AM I HERE?
  1771. Since the file requester can be invoked for many different reasons,the title
  1772. bar of the file requester will give you an indication of why you are being
  1773. asked to select a file name. For example,when loading a Sculpt 4D 24 bit-plane
  1774. file,the title line of the file requester will tell you to select a red file,
  1775. then a green file,and then finally,a blue file.
  1776.  
  1777.                 79
  1778.  
  1779. FIGURE 11.1:THE FILE REQUESTER USED IN ADPRO.
  1780.  
  1781. 11.1 QUITTING THE FILE REQUESTER WITHOUT SELECTING A FILE
  1782. Before we discuss how you can select a file name,let's discuss how you can exit
  1783. the file requester without selecting a file name. This can be done four ways.
  1784. These include:
  1785. 1. You can click the left mouse button over the file requester's close gadget.
  1786. 2. You can erase the destination file name and hit return(in essence,selecting
  1787. no file).
  1788. 3. You can use the file requester Leave command. The Leave command has a
  1789. keyboard binding of RIGHT-AMIGA-1
  1790.  
  1791.                 80
  1792.  
  1793. 4. Finally,you can click the left mouse button over the gadget marked Forget
  1794. it.
  1795.  
  1796. 11.3 THE FILE LIST
  1797. The most prominent feature of the file requester is its file list. The file
  1798. list is the large rectangular area on the left of the file requester.
  1799. Files names are listed in white with their sizes to the right. Directories are
  1800. listed in black and have the text "(dir)" to their right.
  1801. Each directory listed is a subdirectory of the file requester's current
  1802. directory(which can be seen in the box to the right of the word Drawer).
  1803.  
  1804. 11.3.1 WHEN THE FILE LIST IS BEING CREATED
  1805. After you select a new current directory for the file requester(explained
  1806. later),files from the new directory are added to the file list as they are
  1807. found. While the file list is being prepared the file requester is still
  1808. available for your use.
  1809. This means that you may select a file as soon as it is displayed without having
  1810. to wait for the completion of the file list.
  1811. You will note that as the file list is being prepared,files are listed in the
  1812. order in which they are encountered in the current directory. This order will
  1813. almost certainly not be sorted. You will also note that once the displayable
  1814. area of the file list becomes filled,no additional files will be displayed even
  1815.  
  1816.                 81
  1817.  
  1818. though many more files may be present in the directory. This is a purposeful
  1819. design choice to prevent files from moving around in the displayed file list.
  1820. Should you wish the file list to be sorted alphabetically at any time,simply
  1821. click the left mouse button on the slider to the right of the file list or upon
  1822. the scroll arrows above or below the slider. This will instantly sort the
  1823. contents of the file list. You can also accomplish this from the keyboard by
  1824. depressing ALT-RETURN twice.
  1825.  
  1826. 11.3.2 HIDDEN VERSUS VISIBLE FILES
  1827. As the file list is prepared you will notice a line of text near the top of the
  1828. file requester continuously updating. While the file list is still being read
  1829. in,the text will have the form of N shown, M hidden....
  1830. When the file list is complete,the form of this line of text will change to N
  1831. shown,M hidden. Done.. This is your indication that the file list is complete.
  1832. The file requester has the ability to use wild carding and pattern matching to
  1833. show some files in the displayed portion of the file list and to exclude
  1834. others.
  1835.  
  1836. THE SHOWN/HIDDEN COUNT
  1837. The N shown is a count of the number of files which have passed the user
  1838. defined criteria for being displayed in the file list.
  1839. The M hidden is a count of the number of files which do not meet the user
  1840. defined criteria for being visible.
  1841.  
  1842.                 82
  1843.  
  1844. A non-zero value next to the word hidden means that there are more files in the
  1845. current directory than are currently displayed in the file list.
  1846.  
  1847. HIDDEN FILES ARE STILL ACCESSIBLE IN THE FILE LIST
  1848. The criterion used to decide if a file is hidden or not is user defined.
  1849. Therefore,what is hidden at one moment can be made visible in the next simply
  1850. by changing the show or hide criteria.
  1851.  
  1852. HIDING .INFO FILES
  1853. The file requester has one built-in hide/show criteria. Namely,whether or not
  1854. to show .info files. As you know,.info files are created for every file,volume
  1855. or directory accessible from the WorkBench. Since these files are not useful to
  1856. ADPro,.info files are automatically hidden from view.
  1857.  
  1858. 11.3.3 SCROLLING THE FILE LIST
  1859. The scroll bar to the right of the file list and the arrows above and below the
  1860. scroll bar are used to scroll the file list when there are more files in the
  1861. current directory than will fit in the display area on-screen.
  1862. The file list can be scrolled at any time,even while the file list is being
  1863. prepared.
  1864. Selecting the scroll bar or the arrows above or below it will instantly cause
  1865. the contents of the file list to be sorted alphabetically should they be out of
  1866. order.
  1867.  
  1868.                 83
  1869.  
  1870. 11.3.4 REFRESHING THE FILE LIST
  1871. The file requester has been designed to buffer the contents of the current
  1872. directory in the file list so that the file list will not have to be recreated
  1873. each time the requester is activated. As a result of this,it is possible for
  1874. the file list to become out of date with respect to new additions to(or
  1875. deletions from)the current directory.
  1876. For this reason the file requester has the Get Dir gadget located in the bottom
  1877. middle of the file requester. Selecting this gadget with the left mouse button
  1878. will cause the current file list to be thrown away and a new one constructed.
  1879.  
  1880. 11.4 THE DEVICE LIST
  1881. To the right of the file list is a second scrollable area called the device
  1882. list. The device list will contain an entry for each of the following types of
  1883. entities:
  1884. Mounted disk volumes such as DF0:,RAM: or VD0:.
  1885. Logical disk names(the name by which each physical disk device is "labelled").
  1886. Assigned names such as L:,FONTS: and LIBS:.
  1887.  
  1888. Notice that the device list is always kept alphabetically sorted,and that the
  1889. device list is automatically updated for any disk insertions or removals.
  1890.  
  1891.                 84
  1892.  
  1893. 11.5 THE CURRENT DIRECTORY OR DRAWER
  1894. When the file requester appears,it will attempt to display the contents of some
  1895. directory on your system. You can see which directory the file requester is
  1896. currently displaying in the box to the right of the word drawer. The current
  1897. drawer can be any of the following:
  1898. Blank-this indicates that the current directory is the directory containing the
  1899. ADPro program.
  1900. Any directory from any of your disk devices. For example,DF0:s refers to the s
  1901. directory on the disk currently in DF0:.
  1902. Any logical name of any of your disk volumes followed by a colon. For example,
  1903. if you had a disk named WorkBench1.3,the drawer string WorkBench1.3: would
  1904. refer to the root directory of that disk.
  1905. Any logical name created by any assigns you might have made,followed by a
  1906. colon. For example,a drawer string with a value of Devs: would set the file
  1907. requester's current directory to wherever your Devs: directory had been
  1908. assigned.
  1909. Finally,any subdirectory of any of the above. For example,the following string
  1910. might set the file requester's current directory to a directory containing
  1911. pictures of Emily: Work:Pictures/Emily. In this example,Work: is either an
  1912. assigned name or the name of one of your disk drives. Pictures is a sub-
  1913.  
  1914.                 85
  1915.  
  1916. directory contained in the Pictures directory.
  1917.  
  1918. 11.5.1 SETTING THE CURRENT DIRECTORY VIA KEYBOARD
  1919. One way to set the current directory is to enter the directory you wish to
  1920. examine directly into the Drawer gadget.
  1921. Normally,the string gadget to the right of the word File is active. You can
  1922. activate the Drawer gadget by clicking the left mouse button within its box.
  1923. Alternatively,when the File gadget is active,you may hit SHIFT-RETURN. The text
  1924. cursor indicating string gadget activity will shift to the drawer string.
  1925. Since the Drawer gadget is a standard Amiga string gadget,you may use the
  1926. standard AmigaDOS string gadget editing functions upon it. These functions
  1927. include RIGHT-AMIXA-x to clear the string,RIGHT-AMIGA-q to restore the string
  1928. to its original contents,and the shifted left or right arrow keys to move to
  1929. the extreme left or right end of the string.
  1930. When you have entered the path to the directory you wish to examine,hitting
  1931. RETURN will cause the file requester to begin loading that directory. At any
  1932. time you may cause the file list to scroll or be sorted by depressing the left
  1933. mouse button on the file list scroll bar or scroll arrows. Should you see the
  1934. file you wish to operate upon,you may select it while the file list is still
  1935. being prepared.
  1936.  
  1937.                 86
  1938.  
  1939. 11.5.2 SETTING THE CURRENT DIRECTORY WITH THE MOUSE
  1940. You can use the mouse to set the file requester's current directory by clicking
  1941. on an entry in the requester's device list or a subdirectory of the current
  1942. directory from its file list or from a combination of both.
  1943.  
  1944. 11.5.3 CHANGING THE CURRENT DIRECTORY TO ITS PARENT
  1945. So far we have discussed only how to traverse downward deeper into the Amiga's
  1946. hierarchical file system structure. To go back upwards in the file system
  1947. structure you can use the Parent gadget.
  1948. If your current directory was disk:a/b/c then selecting the Parent gadget will
  1949. change your current directory to disk:a/b. Selecting the Parent gadget again
  1950. will change your current directory to disk:a.
  1951. The Parent gadget has a keyboard binding of RIGH-AMIGA-p.
  1952. Note that when your current directory is a disk,volume,or assigned name,
  1953. selecting the Parent gadget will have no effect.
  1954.  
  1955. 11.6 SELECTING A FILE
  1956. At any time,even while the file list is being prepared,you may select a file.
  1957. You can do this by either typing your selection into the File gadget or by
  1958. selecting the desired file from the file list using the left mouse button (you
  1959.  
  1960.                 87
  1961.  
  1962. may have had to scroll the file list to cause the desired file to be visible).
  1963. If you've selected a file by typing its name into the File gadget,the file
  1964. requester will terminate as soon as you hit the carriage return key.
  1965. The file requester may also be terminated using the mouse. This can be done by
  1966. either selecting the OK gadget or by double clicking the left mouse button over
  1967. a specific file in the file list.
  1968.  
  1969. 11.7 THE HIDE AND SHOW GADGETS
  1970. The file requester has a pattern matching facility which is intended to focus
  1971. your attention on a desirable class of files while hiding all others. For
  1972. example,if you were interested in only 18-bit color files,the file requester
  1973. might be instructed to ignore all files except those ending in ".18"(assuming
  1974. you had ended the name of each 18-bit color file saved with ".18").
  1975. The Hide gadget holds a pattern which is applied to each file in the file list.
  1976. If the pattern matches,then the file will not be displayed but will be kept in
  1977. the file list. Files which are hidden can be made visible by changing the
  1978. show/hide criteria.
  1979. The Show gadget holds a pattern which is also applied to each file in the file
  1980. list. If the Show pattern matches,the file will be included in the displayed
  1981. part of the file list.
  1982. Note that the Hide pattern is applied to the file list before the Show pattern.
  1983. Thus,if you specified to hid a given class of files and also specified to show
  1984.  
  1985.                 88
  1986.  
  1987. the same class of files,that class would not be visible.
  1988. You can decide how to make use of the two filters by thinking in the following
  1989. terms: Is the class of desired files easier to define by exclusion or
  1990. inclusion? If the answer is exclusion,the Hide gadget will make displaying the
  1991. desired class of files easier. If the answer is inclusion,then the Show gadget
  1992. will be more easily used.
  1993.  
  1994. 11.7.1 TOGGLING BETWEEN HIDE AND SHOW
  1995. Recall that when the File or Drawer gadgets are active,you can use SHIFT-RETURN
  1996. to toggle between them. In the same way you can use SHIFT-RETURN to toggle
  1997. between the Hide and Show gadgets.
  1998.  
  1999. 11.7.2 TOGGLING BETWEEN HIDE/SHOW AND DRAWER/FILE
  2000. You can toggle between the Hide and Show gadgets using SHIFT-RETURN. Likewise,
  2001. the File and Drawer gadgets can be toggled between themselves using the same
  2002. key sequence. You cn toggle between the two groups by using ALT-RETURN.
  2003. For example,if the File gadget is active,pressing ALT-RETURN will cause the
  2004. Show gadget to become active. Pressing again will cause the File gadget to
  2005. become active. Similarly,if the Drawer gadget were active,pressing ALT-RETURN
  2006. would cause the Hide gadget to become active.
  2007.  
  2008.                 89
  2009.  
  2010. 11.7.3 PATTERN MATCHING IN THE HIDE AND SHOW GADGETS
  2011. The Hide and Show gadgets can accommodate strings conforming to a simple
  2012. grammar. The grammar is sufficient to define nearly any combination of Hide and
  2013. Show classes you might want.
  2014. The best way to explain the file requester's use of wild cards and pattern
  2015. matching for the Hide and Show gadgets is to plow right through the explanation
  2016. and give examples. Here's the explanation:
  2017. The grammar includes wild cards defined in either AmigaDOS or Unix format. This
  2018. means that single character substitutions can be defines as "?" while multiple
  2019. character substitutions can be defined as either "#?" or "*".
  2020. Patterns may include the or-operator, "|". There is no need for an
  2021. and-operator.
  2022. And here are some examples:
  2023. For the Show gadget to match all files ending in ".18" you would set it to:
  2024. *.18 meaning "match anything followed by a '.18'".
  2025. For the Show gadget to match all files ending in "18","ham","ares",and "pic"
  2026. you would set the Show gadget to:
  2027.         *18|*ham|*ares|*pic
  2028.  
  2029.                 90
  2030.  
  2031.             CHAPTER 12 - TIPS AND TRICKS
  2032.  
  2033. This chapter is reserved for descriptions of Art Department tips and tricks. We
  2034. cannot hope to discover all of the tips and tricks which you the user will
  2035. discover. So,please send descriptions of new techniques or tricks which you
  2036. might discover to us for inclusion in future revisions of the manual.
  2037.  
  2038. 12.1 TURN ONE BIT MONOCHROME IMAGES INTO GRAY SCALE
  2039. Many scanner systems provide only one bit-plane or monochrome data output.
  2040. Also,limited computers such as the original Apple Macintosh operate on only one
  2041. bit-plane monochrome image into gray scale using the following technique.
  2042. Load the one bit-plane image using the appropriate Loader. The Loader will
  2043.  
  2044.                 91
  2045.  
  2046. recognize the image to be a one bit-plane image and convert it into an 8 bit-
  2047. plane gray scale image internally. Next,reduce the width and height of the
  2048. image by 50 or more percent. ADPro's scaling code will produce gray scales
  2049. where there were none before. Now render the image with dithering and in 16
  2050. shades of gray.
  2051.  
  2052. 12.2 TURN LOW COLOR IMAGES INTO HIGHER RES GRAY SCALE
  2053. Using a technique similar to the one previously outlined,you can take a 16
  2054. color Amiga format image(for example)and turn it into a gray scale image with
  2055. many more than 16 shades of gray.
  2056. Load the low color image into ADPro. The ADPro Loader will detect that the
  2057. image is colored and will pad it into 24 bit-planes. Reduce the width and
  2058. height of the image by more than 50 percent. Then convert the image to gray
  2059. scale. The resulting 8 bit-plane image will possess more than 16 gray scades.
  2060.  
  2061. 12.3 GRAY SCALE BALANCING
  2062. We have found that some very striking results can be had in gray scale by
  2063. heavily increasing contrast and then adjusting brightness or gamma or both.
  2064. While color images are best brightened using the gamma correction,we have found
  2065. that adjusting the brightness of a gray scale image(using the brightness
  2066. control)will give a more natural looking result.
  2067.  
  2068.                 92
  2069.  
  2070. 12.4 APPROXIMATING CHARCOAL DRAWINGS
  2071. You can create a charcoal-like result by combining some of the features of
  2072. ADPro. If you are starting from a color image,turn it into gray scale. Boost
  2073. the contrast heavily and select the line art command. Next,select a 2 color
  2074. screen and Floyd-Steinberg dithering and render the image. Finally,execute the
  2075. Remove Isolated Pixels command. The resulting image should have a rubbed
  2076. charcoal-like quality.
  2077.  
  2078. 12.5 MIXING PICKED AND COMPUTED COLORS
  2079. In some instances it might be desired to pick some of the screen's colors by
  2080. hand and let the computer pick the rest. For example,you might want to ensure
  2081. that several specific colors are present in the rendered image.
  2082. Let's take a complicated example of a 32 color screen in which the following
  2083. requirements are to be met:
  2084. Color registers 0 through 7 are to be ignored completely.
  2085. Color registers 8 through 15 will contain hand picked colors.
  2086.  
  2087.                 93
  2088.  
  2089. Color registers 16 through 31 are to be picked by the computer.
  2090. This can be accomplished as follows:
  2091. First,enter the Palette control panel and set the total number of colors to 32.
  2092. Then set the number of colors to use to 16 and the offset of color zero to 16.
  2093. Exit the Palette control panel.
  2094. Second,select the CUST screen mode and hit the Execute button. The resulting
  2095. image will have 16 computer picked colors in registers 16 through 31.
  2096. Next,enter the Palette control panel again. Set the number of colors to use to
  2097. 24 and set the offset zero value to 8. Edit the palette to place the hand
  2098. picked colors into registers 8 through 15(this can be accomplished via palette
  2099. loading as well).
  2100. Set the palette to Locked and exit the Palette control panel.
  2101. Finally,rerender the image with the screen mode still set to CUST. The
  2102. resulting image will use all registers between 8 and 31 including the 8 which
  2103. were hand picked and the 16 which were computer picked. It will avoid color
  2104. registers 0 through 7 completely.
  2105. Using this technique you can have enormous flexibility in color composition for
  2106. vide titling,animation,or other video applications.
  2107.  
  2108. 12.6 ELIMINATING STRAY DOTS
  2109. As mentioned elsewhere in this manual,there are two principal methods for
  2110.  
  2111.                 94
  2112.  
  2113. eliminating stray dots which can crop up especially in dithered renderings.
  2114. These are:
  2115. 1. Increasing the contrast of the image very slightly will often eliminate hugh
  2116. amounts of stray dots especially in dithered renderings. Increasing the
  2117. contrast has the effect of decreasing the subtle variations in shading which
  2118. the dithering routines are trying to represent when they produce seemingly
  2119. stray dots.
  2120. 2. The RIP function can also remove stray dots very effectively. This is in
  2121. fact,the purpose for which it was designed. RIP is especially useful when
  2122. working with line or drawn art.
  2123. However,when working with scanned art be aware that applying RIP will remove
  2124. isolated pixels in the entire image. This means that RIP will slightly degrade
  2125. the quality of whatever dithering was used by removing some stray dots that
  2126. were visually important.
  2127. Therefore,when working with full color images we suggest that you first attempt
  2128. to deal with stray dots by slightly increasing the contrast of the image before
  2129. using RIP.
  2130.  
  2131. 12.7 CREATING BETTER GRADATED FILLS
  2132. For display upon the Amiga,here are some tips for creating smoother gradated
  2133. fills. I you are using actual 24 or 8 bit-plane data(for example,driving a 24
  2134. bit-plane film recorder or display board)then these tips are not as useful.
  2135.  
  2136.                 95
  2137.  
  2138. Where possible,vary only one primary color.
  2139. If you vary only one primary color in a gradated fill,the resulting fill will
  2140. appear much smoother than if more then one primary color varies. This is
  2141. because of the limited color resolution of the Amiga. If you vary more then one
  2142. primary color,the primaries will vary at different rates causing a strobing
  2143. effect in the Amiga displayable image.
  2144. Where possible,draw in an oversized bitmap.
  2145. For example,if you wish to produce a 320 by 200 end product,you will get better
  2146. results by creating a 640 by 400 bit-map and then scaling downward by 50
  2147. percent. The larger the size of the bitmap,the more finely ADPro will create a
  2148. gradated fill.
  2149.  
  2150. 12.8 CREATING A SOLARIZATION
  2151. Solarizations can be created quickly and easily using the dynamic range
  2152. Operator twice. First,reduce the dynamic range of the image drastically(perhaps
  2153. to a range of 0 to 2). Then re-expand the dynamic range back to 0 to 255. The
  2154. resulting image is a solarization of the original.
  2155.  
  2156. 12.9 MERGING A COLOR IMAGE INTO A GRAY SCALE IMAGE
  2157. When merging a gray scale image into a color background,you are adding an 8
  2158. bit-plane image to a 24 bi-plane background. However,to add a color image to a
  2159.  
  2160.                 96
  2161.  
  2162. gray scale background,you would need to add a 24 bit-plane image to an 8 bit-
  2163. plane background. Since 24 bit-planes won't fit in 8,but the ability to add a
  2164. color image to a gray scale background would be nice,the gray to color operator
  2165. was defined.
  2166. It takes 8 bit-plane raw image data and creates the equivalent gray scale data
  2167. spread over 24 bit-lanes. It does this by making each primary color equal and,
  2168. thereby,gray.
  2169. To add a color image to a gray scale background you would first load the gray
  2170. scale image which will become your background. Execute the gray to color
  2171. operator. This causes ADPro to create 24 bit-plane data(which happens to be
  2172. gray)from the original 8 bit-plane data.
  2173. Now,you can directly merge a color image since 24 bit-planes are now available
  2174. for ADPro's internal use.
  2175.  
  2176. 12.10 CREATING DROP SHADOWS
  2177. Drop shadows can be created using the rectangle operator and by using a
  2178. combination of mixing and transparancy during image compositing. To create a
  2179. drop shadow for a rectangular region,simply draw a filled black rectangle at a
  2180. 50 percent mix. To create a drop shadow for a complex image,create a black and
  2181. white mask where the black area is the area which will cast the shadow. Then,
  2182. use image compositing to load in the mask at an offset and at a 50 percent mix
  2183. with white being transparant.
  2184. After the shadow has been created,load in the image which is supposed to cast
  2185.  
  2186.                 97
  2187.  
  2188. the shadow. Since this image is loaded after the shadow is drawn,it will
  2189. obscure the appropriate areas to make a realistic looking shadow.
  2190.  
  2191. 12.11 FOCUSED COLOR PICKING
  2192. Sometimes,when rendering a 24 bit-image into a small number of colors,you might
  2193. want to channel ADPro's color picking to give a small area of the total bit-map
  2194. the best possible color choices(while sacrificing color quality elsewhere in
  2195. the image).
  2196. Left alone,ADPro will choose the color which best matches the entire image.
  2197. However,using the crop operator you can channel ADPro's color picking to
  2198. optimally pick colors based upon only a small subsection of the entire image.
  2199. This can be done as follows:
  2200. Save out the 24 bit-plane image because you will need to preserve it through
  2201. the next steps.
  2202. Using the crop operator,crop the area of focus for color picking.
  2203. Have ADPro choose the desired number of colors based upon the cropped area.
  2204. Lock the palette.
  2205. Reload in the original image saved in the first step. Remember,the palette is
  2206. locked.
  2207. Render the entire image in the desired number of colors using the locked
  2208. palette. Because you are using the locked palette based only upon the sub-
  2209.  
  2210.                 98
  2211.  
  2212. region,that region will have optimal color choices within the entire image.
  2213.  
  2214. 12.12 TIPS FOR COMPOSITING
  2215. ADPro's image compositing capabilities include the ability to select a specific
  2216. color as being transparent. As an image is loaded during a compositing
  2217. operation,each pixel is compared against the transparent color. If the pixel
  2218. matches the transparent color,the new pixel is ignored and a pixel from the old
  2219. image is left untouched.
  2220. This capability can be used in a two step masking process to paste an arbitrary
  2221. shape from one image into another.
  2222. Suppose you had a 24 bit-plane scan of a full moon that you wish to place into
  2223. a ray-tracing.
  2224. First,load the scan of the moon into ADPro. Render the image(with dithering)in
  2225. any Amiga display mode which is compatible with your favorite paint program. We
  2226. recommend 32 colors,low resolution,non-interlaced. We suggest that this
  2227. rendering be made with dithering on so that you can get the best impression of
  2228. what the 24 bit-plane data looks like.
  2229. Save this rendering under a different name from the original 24 bit-plane data.
  2230. Do not overwrite the 24 bit-plane data as this will be needed later.
  2231. Load the rendered data into your favorite paint program. For our example,we
  2232. assume Deluxe Paint III. Bring up the image's palette. Make color register 0
  2233. completely black,that is make its red green and blue components all zero. Also,
  2234.  
  2235.                 99
  2236.  
  2237. make the highest color register completely white(red,green,and blue all 15's).
  2238. Select color register 0(completely black)as your pen color and trace around the
  2239. perimeter of the moon. When this is done,fill the outside of the moon
  2240. completely with color register 0. In Deluxe Paint III this an be done easily
  2241. with ALT-FILL. Next,fill the inside of the moon with the completely white color
  2242. register. Save this image(overwriting its former self is acceptable). This is
  2243. your mask.
  2244. Load the original 24 bit-plane moon image. Select the image compositing mode
  2245. and then load the mask. When the image compositing control panel comes up
  2246. specify that you wish white(255,255,255)to be the trasparent color. Specify an
  2247. x and y offset of 0 so that the images completely overlap. Perform the load.
  2248. What you should now have in memory is the 24 bit-plane moon left completely
  2249. untouched. However,it's background should now be set completely and uniformly
  2250. to black. Save this 24 bit-plane file for use later.
  2251. To complete the process load the ray-tracing. Then,in compositing mode,load the
  2252. 24 bit-plane image saved in the previous step. This time,specify black(0,0,0)to
  2253. be the transparent color. This instructs ADPro to load just the moon into the
  2254. ray-tracing since the background of that image is uniformly "transparent".
  2255.  
  2256.                 100
  2257.  
  2258. 12.13 CREATING AN EMBOSSED LOOK
  2259. Using ADPro,it is trivial to create an embossed look. Embossing is a process of
  2260. pressing an image into the paper to create a raised impression(or depression)of
  2261. the image. The following ARexx program performs this effect on a specified
  2262. image:
  2263.  
  2264. /**/
  2265. address "ADPro"
  2266.  
  2267. options results
  2268.  
  2269. getfile '"Select File To Be Embossed"'
  2270. if RC ~=0 then exit
  2271. TheFile = ADPRO_RESULT
  2272.  
  2273. lformat "IFF"
  2274. load TheFile
  2275. if RC `= 0 then do
  2276.         okay1 "Error Loading" TheFile
  2277.         exit
  2278.  
  2279. end
  2280.  
  2281. operator "negative"
  2282. load TheFile 1 1 50
  2283. if RC ~= 0 then do
  2284.         okay1 "Error Reloading" TheFile
  2285.         exit
  2286.  
  2287. end
  2288.  
  2289.                 101
  2290.  
  2291. operator "color_to_gray"
  2292. contrast 50
  2293. execute
  2294. adpro_display
  2295.  
  2296. The embossed look is created by averaging a slightly offset image with the
  2297. negative of itself. Notice how the ARexx program loads the image once then
  2298. performs the negative operator and then loads the image in again slightly
  2299. offset and with only a 50 percent mix. This instructs ADPro to take a straight
  2300. average between the versions.
  2301. Different embossing effects can be had by changing the offset at which the
  2302. image is loaded the second time.
  2303.  
  2304.                 102
  2305.  
  2306.             THIS PAGE IS BLANK
  2307.  
  2308.                 103
  2309.  
  2310.             THIS PAGE IS BLANK
  2311.  
  2312.                 104
  2313.  
  2314.             CHAPTER 13 - STANDARD LOADERS
  2315.  
  2316. This chapter provides a detailed description on the use and operation of the
  2317. loaders which are included with ADPro. General information about loaders,
  2318. including how the image compositing control panel is operated,can be found in
  2319. Chapter 5.
  2320.  
  2321. 13.1 DPIIE
  2322. The DPIIE format was defined by Electronic Arts for use in their produce
  2323. "Deluxe Paint II Enhanced" for the IBM P.C. DPIIE images contain 256 colors.
  2324. Deluxe Paint II Enhanced for the P.C. saves images with less than 256 colors in
  2325. the standard Amiga IFF format.
  2326. To read an image in the DPIIE format,select the DPIIE loader with the load
  2327. format button. Then,select the load button to cause the file requester to
  2328. appear. Use the file requester to select a file in the DPIIe format. After
  2329. selecting a file,the image compositing control panel will appear if compositing
  2330. is enabled.
  2331.  
  2332.                 105
  2333.  
  2334. The DPII3 loader fully supports image compositing. For more information about
  2335. compositing,please refer to section 5.5.
  2336.  
  2337. 13.2 DV21
  2338. The DV21 loader can process the 21 bit-plane files saved by Newtek's Digi-View
  2339. 3.0 only. A 21 bit-plane file saved by Digi-View must be read by the Super-IFF
  2340. loader.
  2341. Files loaded by this module are always considered to be color images. As the
  2342. image is loaded it will be padded to a full 24 bit-planes.
  2343. To load a 21 bit-plane file saved by Digi-View 3.0,select the DV21 loader with
  2344. the load format button. After selecting a file,the image compositing control
  2345. panel will appear if you are in image compositing mode.
  2346. The DV21 loader fully supports image compositing. For more information about
  2347. compositing,please refer to section 5.5.
  2348.  
  2349. 13.3 BACKDROP
  2350. Don't let the name,BACKDROP,fool you. The BACKDROP loader is one of the most
  2351. important loaders provided with ADPro. Using it,you can create a "canvas" upon
  2352. which you can add other images using ADPro's image compositing features.
  2353. At the same time the BACKDROP loader creates an empty bit-map of some given
  2354. size,you can aski it to fill the bit-map with a specific color or even a 
  2355.  
  2356.                 106
  2357.  
  2358. FIGURE 13.1:THE BACKDROP LOADER CONTROL PANEL.
  2359.  
  2360. gradation of colors. Gradated background fills are very common in presentation
  2361. or business graphics.
  2362. Figure 13.1 shows the user interface for the BACKDROP loader.
  2363. The BACKDROP loader can prepare one of two different types of bit-maps. A 24
  2364. bit-plane raw color bit-map can be prepared by selecting a setting of Colr
  2365. which is shown in figure 13.1. Selecting this button causes it to toggle to its
  2366. alternate state,Gray,which instructs the BACKDROP loader to prepare a 8 bit-
  2367. plane gray scale bit-map.
  2368. The size of the bit-map to be prepared is specified by the gadgets to the right
  2369. of the markings W(for bit-map width)and H(for bit-map height).
  2370. The button above the width and height gadgets determines how the resulting bit-
  2371. map will be filled. If in the Grad setting as in figure 13.1,the bit-map will
  2372.  
  2373.                 107
  2374.  
  2375. be filled with a smooth shaded gradated fill. If set to Fill the bit-map will
  2376. be set to one constant color.
  2377. You may specify the nature of a gradated fill by selecting each of the four
  2378. blank rectangular buttons in the upper half of the control panel. Each of these
  2379. buttons represents the corresponding corner of the image. That is,the upper
  2380. left hand button corresponds to the upper left hand corner of the image.
  2381. These buttons are enabled whenever you have a gradated fill selected. If you
  2382. were to toggle the fill type button to Fill,these buttons become disabled.
  2383. A non-gradated color fill can be specified simply by setting the desired color
  2384. into the red,green,and blue sliders or gadgets. When a gray scale bit-map is
  2385. selected,the red and blue sliders/gadgets disappear leaving only a slider/
  2386. gadget pair marked G for gray.
  2387. As you can change the red,green,or blue(or just the gray)component of the color
  2388. being entered,the numerical value of the color will be updated. The
  2389. corresponding color will be displayed in a small rectangular area above the
  2390. button marked copy. Remember,that you are entering color components with 24 bit
  2391. accuracy. The color displayed above the copy button is only accurate to the 12
  2392. bit limit of the Amiga's palette. Therefore,slight adjustments in the numerical
  2393. value of the color may not be visible on-screen.
  2394. When ADPro constructs a gradated fill,the color of each pixel is computed as a
  2395. linear interpolation both horizontally and vertically.
  2396. To copy the color of one corner to another,select the corner you wish to copy
  2397. from,then select the Copy button and finally select the corner you wish to copy
  2398.  
  2399.                 108
  2400.  
  2401. to.
  2402. The BACKDROP loader does not support image compositing. If you wish to composite 
  2403. a solid rectangle,then use the rectangle operator. If you wish to composite a
  2404. gradated rectangle,then gradated area and save it as a 24 bit IFF file. Then
  2405. composite with it as you would any IFF file.
  2406.  
  2407. 13.4 GIF
  2408. The GIF format was defined by CompuService Information Service,Inc. for storing
  2409. images in a compressed form on their information network. The GIF format is
  2410. very widely used on IBM and Apple computers. GIF images may contain from 1 to
  2411. 256 colors.
  2412. The ADPro GIF loader supports both the 87a and 89a GIF standards including
  2413. interlaced GIF images. It supports multi-image GIF files as well.
  2414. To read an image in the GIF format,select the GIF loader with the load format
  2415. button. Then,select the load button to cause the file requester to appear.
  2416. After selecting a file in GIF format,the image compositing control panel will
  2417. appear if compositing is enabled.
  2418. The GIF loader fully supports image compositing. For more information about
  2419. compositing,please refer to section 5.5.
  2420.  
  2421. 13.5 IFF
  2422. The Super-IFF loader can read files in many IFF formats including the
  2423. following:
  2424.  
  2425.                 109
  2426.  
  2427. Commodore standard IFF files in 1 through 5 bit-planes corresponding to 2
  2428. through 32 colors.
  2429. Commodore standard IFF files in the Amiga Extra-HalfBright format(64 colors).
  2430. Commodore standard IFF files in the Amiga Hold-And-Modify format(4096 colors).
  2431. IFF files in Sliced-HAM(SHAM)format(can be read but not written).
  2432. IFF files in A-HAM or Dynamic HAM formats(4096 colors).
  2433. IFF files in A-RES or Dynamic HI-RES formats(4096 colors in hi-res).
  2434. Commodore standard IFF files in 12,15,18,21,and 24 bit-planes(4096,32768,
  2435. 262144,2097152,and 16777216 colors respectively). This includes 21 bit-plane
  2436. files created by Digi-View 4.0.
  2437. The Super-IFF loader will look for a palette in the image file. If there is
  2438. one,it will be tested to see if it contains only gray scales. If it does,the
  2439. image will be loaded into 8 bit-planes and will be treated as gray scale image
  2440. data. Otherwise,the image will be loaded into 24 bit-planes and treated as a
  2441. color image.
  2442. When attempting to load an image already in a displayable Amiga format(such as
  2443. the 1 to 6 bit-plane formats)and there isn't enough memory to convert the full
  2444. image into 24 bit-planes or 8 bit-planes if gray scale),the Super-IFF loader
  2445. will simply load the image and not convert it into a deep bit-plane format.
  2446. This means you will be able to view the image and edit its palette but you will
  2447.  
  2448.                 110
  2449.  
  2450. not be able to perform any other of ADPro's image processing functions.
  2451. To load an IFF file,select IFF using the load format button and then click on
  2452. the load button. The Super-IFF loader will bring up the file requester for you
  2453. to select a file for loading. After selecting a file in the IFF format,the
  2454. image compositing control panel will appear if compositing is enabled.
  2455. The IFF loader fully supports image compositing. For more information about
  2456. compositing,please refer to section 5.5.
  2457.  
  2458. 13.6 IMPULSE
  2459. The IMPULSE formats are defined by Impulse,Inc. for use with their color
  2460. products such as Turbo-Silver and Imagine. ADPro's IMPULSE loader supports
  2461. reading the RGBN and RGB8 IMPULSE formats. The RGBN format stores 4 bits per
  2462. primary color giving a total of 12 bit-planes. The RGB8 format stores 8 bits
  2463. per primary giving a total of 24 bit-planes of color information.
  2464. To read an image in either format,select the IMPULSE loader with the load
  2465. format button. Then,select the load button to cause the file requester to
  2466. appear. After selecting a file in either IMPULSE format,the image compositing
  2467. control panel will appear if compositing is enabled.
  2468. Files in the IMPULSE format are always interpreted as color images.
  2469. The IMPULSE loader fully supports image compositing. For more information about
  2470. compositing,please refer to section 5.5.
  2471.  
  2472.                 111
  2473.  
  2474. 13.7 PCX
  2475. The PCX format was defined by the ZSoft Corporation for use in their product
  2476. "PC Paint Brush." PCX images may contain from 1 to 256 colors including special
  2477. palettes for IBM PC EGA and CGA display boards.
  2478. The ADPro PCX loader will correctly interpret all PCX images including those
  2479. with CGA and EGA palettes.
  2480. To read an image in the PCX format,select the PCX loader with the load format
  2481. button. Then,select the load button to cause the file requester to appear.
  2482. After selecting a file in the PCX format,the image compositing control panel
  2483. will appear if compositing is enabled.
  2484. The PCX loader fully supports image compositing. For more information about
  2485. compositing,please refer to section 5.5.
  2486.  
  2487. 13.8 SCREEN
  2488. The SCREEN loader is an example of the versatility of the ADPro loader/saver
  2489. interface. It doesn't load an image from disk as the other standard loaders do.
  2490. Rather,it captures the rendered image data from another Amiga screen and
  2491. converts this data for use by ADPro.
  2492. Selecting the load button causes the SCREEN loader to make a list of the
  2493. currently defined Amiga screens. Each screen will be listed by its Intuition
  2494. screen name. If a screen does not have an Intuition screen name,then its name
  2495. will be presented as No Name. If more than one screen has no Intuition name,
  2496.  
  2497.                 112
  2498.  
  2499. each No Name will be differentiated by a sequence number.
  2500. Select a screen to capture by clicking on the button containing the screen's
  2501. name. You may confirm that this is the screen you intend to capture by clicking
  2502. on the button marked Show. The select screen will be brought to front. A click
  2503. of the left mouse button will bring ADPro back to front.
  2504. There are two ways to actually load the selected screen. First,you may depress
  2505. the Grab button after selecting one of the screen choices in the SCREEN loader
  2506. control panel. The selected screen will be loaded into ADPro and can then be
  2507. processed as if it were any other type of loaded image.
  2508. The first method of screen grabbing cannot allow you to grab a screen while
  2509. that screen is showing menus. This is because you(the user)can't be in two
  2510. places at one time(i.e.:pushing the grab button and holding down the menu
  2511. button in the screen you wish to grab).
  2512. The second method allows you to grab a screen including its menu.
  2513. When the SCREEN loader begin executing,it temporarily installs a hot key
  2514. sequence of RIGHT-ALT-RIGHT-SHIFT-BACKSPACE. When the SCREEN loader exits it
  2515. removes the hot key sequence from the system's input chain.
  2516. You can grab any screen including its menus by selecting the SCREEN loader and
  2517. then bringing the desires screen to front,causing the desired menu to appear,
  2518. and then depressing the hot key sequence. When you release the keys(while still
  2519. holding down the right mouse button),the active screen will be loaded including
  2520.  
  2521.                 113
  2522.  
  2523. the active menus.
  2524. After selecting a screen to be grabbed,the image compositing control panel will
  2525. appear if compositing is enabled.
  2526. The SCREEN loader fully supports image compositing. For more information about
  2527. compositing,please refer to section 5.5.
  2528.  
  2529. 13.9 SCULPT
  2530. The SCULPT format was actually defined by Mimetics Corporation for use with
  2531. their 24 bit-plane frame buffer. The format is better known as the format
  2532. produced by Byte-By-Byte's SCULPT series of 3D modelling products.
  2533. The SCULPT format has no header information at all contained in the image
  2534. itself. Therefore,you must remember the exact dimensions of the image in order
  2535. to correcly load an image in the SCULPT format.
  2536. After selecting the SCULPT loader and hitting the load button,you will be asked
  2537. to enter a width and height of the image to be loaded. Remember,that the SCULPT
  2538. format does not store the width and height as header information in the data
  2539. files. Therefore,you must keep track of these values yourself.
  2540. The SCULPT loader can load a combination of three files to form a color image,
  2541. or load a single file to create a gray scale image. After specifying a width
  2542. and height,select which type of image(color or gray scale)you wish to load.
  2543. If loading a color image,you will be asked to specify three image files 
  2544.  
  2545.                 114
  2546.  
  2547. containing the red,green,and blue information for the image respectively.
  2548. ADPro will check the size of each of three files you must specify against the
  2549. width and height you provided. If the size of one of the specified files does
  2550. not match the size indicated by the entered width and height,the load is
  2551. aborted.
  2552. There is a naming convention for images stored in the SCULPT format. This
  2553. convention dictates that each of the three raw image files comprising one
  2554. SCULPT image share the same root file name and have the extensions red,grn,and
  2555. blue for the red,green,and blue components respectively.
  2556. When you specify the name of the red component,if you do not specify a file
  2557. name extension,or if the extension you specify is red,then the SCULPT loader
  2558. will automatically generate the conventional extensions for the green and blue
  2559. components.
  2560. The Mimetics frame buffer software also uses ored,ogrn,and oblu extenstions to
  2561. signify that the image in question is overscanned. The SCULPT loader will
  2562. automatically generate these extensions where appropriate as well.
  2563. When loading a gray scale file,you will be asked to select only one file in the
  2564. SCULPT format.
  2565. After selecting all appropriate files,the image composition control panel will
  2566. appear if composition is enabled. The SCULPT loader fully supports image
  2567. compositing. For more information about compositing,please refer to section
  2568. 5.5.
  2569.  
  2570.                 115
  2571.  
  2572.             PAGE 116-188 ARE BLANK
  2573.  
  2574.             CHAPTER 14 - STANDARD SAVERS
  2575.  
  2576. This chapter describes the use and operation of the savers which are included
  2577. in the basic ADPro package.
  2578. To select a particular saver,reptitively select the save format button until
  2579. the desired saver appears. Remember that the save format button is logically
  2580. divided into two halves. Clicking on the left or right half will cycle the
  2581. choices in a backwards or forward order.
  2582. Note that some savers support only specific types of data. Usually,this is
  2583. because of restrictions in the format that the saver implements. The different
  2584. types of data which can be saved can be characterized as follows:
  2585.  
  2586. Raw -  Raw image data is either 24 bit-plane color or 8 bit-plane gray scale 
  2587. data.
  2588. Rendered - Rendered image data can be color or gray scale and will comprise
  2589. from 1 to 8 bit-planes(2 to 256 shades).
  2590.  
  2591.                 119
  2592.  
  2593. Screen - Screen image data is that portion of the rendered image which can be
  2594. seen if you were to select the redisplay button. Screen image data is available
  2595. only when the image has been rendered in one of the Amiga displayable modes.
  2596. When a saver supports more than one of these types of data,it will ask you to
  2597. select which type you wish to save.
  2598. When using a saver which can write to disk,the file requester will appear for
  2599. you to select the destination file name. The file requester is described in
  2600. chapter 11.
  2601.  
  2602. 14.1 DPIIE
  2603. You must have rendered data available in order to save in the DPIIe format. To
  2604. use the DPIIe format,the image must have been rendered with 256 colors. If you
  2605. wish to save an image for use with DPIIe with fewer colors than 256,you can use
  2606. the standard IFF saver.
  2607. The file requester will then appear. Use it to select a file name in which to
  2608. save the rendered image. For more information about the file requester,please
  2609. refer to chapter 11.
  2610. Note that you can benefit from use of the enhanced palette mode when saving
  2611. images for use with Deluxe Paint II Enhanced.
  2612.  
  2613.                 120
  2614.  
  2615. 14.2 FRAMEBUFFER
  2616. The FRAMEBUFFER saver requires the presence of raw image data. It writes this
  2617. type of data to a Mimetics FrameBuffer,if you have one installed in your Amiga.
  2618. The FRAMEBUFFER saver uses a device control library supplied by Mimetics
  2619. Corporation to encode RGB data into the kind of data into the kind of data used
  2620. by the FrameBuffer board. The encoding process(performed by the library
  2621. supplied by Mimetics)requires approximately 700K bytes of free memory in order
  2622. to function. Therefore,it may be necessary to use the MAXMEM tool type to
  2623. ensure the availability of enough free memory to use this saver. For more
  2624. information about the MAXMEM tool type,refer to section 4.3.
  2625. The saver will center the image on the FrameBuffer's screen if the image is
  2626. smaller than the maximum size of the FrameBuffer's imaging area(768 by 484
  2627. pixels). If the image is larger than the FrameBuffer's imaging area,only the
  2628. upper right portion of the image will be shown.
  2629. Any work-in-progress within ADPro can be previewed on the Mimetics FrameBuffer
  2630. by selecting the FRAMEBUFFER saver and selecting the save button.
  2631. This saver is an example of how ADPro can be used as the central controller of
  2632. diverse graphics peripherals. If there are other imaging peripherals you would
  2633. like to see directly supported by ADPro,please contact ASDG.
  2634.  
  2635.                 121
  2636.  
  2637. 14.3 GIF
  2638. The GIF saver requires the presence of rendered image data which cannot be in
  2639. the Amiga specific formats of HAM,EGB,AHAM,ARZ0,or ARZ1.
  2640. Upon selecting the save button you will be given the choice of which data to
  2641. save. If the rendered data is in one of the allowable Amiga display modes,you
  2642. can select cropped screen image to save only the portion of the image which
  2643. would be visible if you selected the redisplay button. Or,you can select the
  2644. button describing the full size and number of colors of the rendered data to
  2645. save the entire rendered image.
  2646. The file requester will then appear. Use it to select a file name in which to
  2647. store the GIF image. For more information about the file requester,please refer
  2648. to chapter 11.
  2649. Note that you can benefit from use of the enhanced palette mode when saving
  2650. images for use with applications which can read GIF.
  2651.  
  2652. 14.4 IFF
  2653. The IFF saver supports saving,raw,rendered,and screen image data. You will be
  2654. asked to select one of the following:
  2655. Cropped Screen Image - Selecting this mode will save the screen image data
  2656. which would be displayed if you select the redisplay button. This choice is
  2657. available only if you have rendered in an Amiga displayable mode.
  2658.  
  2659.                 122
  2660.  
  2661. N Color Image - Selecting this mode will save the entire rendered image. The
  2662. number of colors in the rendered image will be presented in place of the N.
  2663. This choice is available whenever rendered image data is available even if the
  2664. rendering mode is not directly Amiga displayable.
  2665. N Bit-Plane Raw Image - Selecting this mode will save the entire raw image as
  2666. either a 24 bit-plane color image or 8 bit-plane gray scale image.
  2667. Whenever a raw image is saved,ADPro includes Commodore standard CLUT chunks
  2668. which represent your current color balancing settings. However,many programs
  2669. which now support Commodore standard 24 bit-plane IFF files do not yet support
  2670. CLUT chunks. To enable you to get exactly the image you intend,you can use the
  2671. apply map operator to permanently modify the raw data to include the effect of
  2672. the CLUT chunks.
  2673. Raw images saved in the IFF format by ADPro also include an ASDG chunk which
  2674. preserves the internal representation of your current color balancing settings.
  2675. Reading and rewriting such a file in a non-ASDG program will more than likely
  2676. cause the ASDG chunk to be removed. However,this means only that the color
  2677. balance settings are lost and not that the data has been modified. You can
  2678. reset the color balance settings by hand if you need them again.
  2679. After selecting which type of data to be saved by the IFF saver,the file
  2680. requester will appear allowing you to specify the output file destination. For
  2681. more information about the file requester,please refer to chapter 11.
  2682.  
  2683.                 123
  2684.  
  2685. 14.5 IMPULSE
  2686. The IMPULSE saver requies the presence of 24 bit-plane raw color image data.
  2687. You will be asked to select between RGBN and RGB8 formats. The RGBN format is a
  2688. 12 bit-plane format in which ADPro will truncate the least significant four
  2689. bits from each of the red,green and blue components of the image. The RGB8
  2690. format is a 24 bit-plane format in which ADPro will preserve the entire raw
  2691. image it has.
  2692. After selecting which type of data to be saved by the IMPUSLE saver,the file
  2693. requester will appear allowing you to specify the output file destination. For
  2694. more information about the file requester,please refer to chapter 11.
  2695. While this format supports only raw image data,it does not contain its own
  2696. color look-up tables. Therefore,in order to preserve the effect of any color
  2697. balance settings you might with to maintain,use the apply map operator to
  2698. transfer the effect of the color settings into the raw image data.
  2699.  
  2700. 14.6 PCX
  2701. The PCX saver can save two types of image data. First,if you are processing a
  2702. gray scale image,it can save the raw or rendered image. If you are processing a
  2703. color image,it can save only the rendered image data.
  2704. The PCX saver cannot save an image rendered in one of the Amiga specific modes
  2705. such as HAM,EGB,AHAM,ARZ0,and ARZ1.
  2706.  
  2707.                 124
  2708.  
  2709. Upon selecting the save button,you will be given a choice of which data to
  2710. save. If the rendered data is in one of the allowable Amiga display modes,you
  2711. can select cropped screen image to save only the portion of the image which
  2712. would be visible if you selected the redisplay button. Or,you can select the
  2713. button describing the full size and number of colors of the rendered data to
  2714. save the entire rendered image. Also,you may elect to save the raw image data
  2715. if you are processing a gray scale image.
  2716. The file requester will appear. Use it to select a file name in which to store
  2717. the PCX image. For more information about the file requester,please refer to
  2718. chapter 11.
  2719. Note that you can benefit from use of the enhanced palette mode when saving
  2720. images for use with applications which can read PCX.
  2721.  
  2722. 14.7 POSTSCRIPT
  2723. PostScript is a typesetting and page description language defined(and
  2724. trademarked)by Adobe Systems Incorporated. ADPro can save a wide range of data
  2725. in the form of a PostScript file. Such a file can be sent directly to a
  2726. PostScript compatible printer or,in the case of Encapsulated PostScript,can be
  2727. imported into other programs.
  2728. The PostScript saver always requires the availability of raw image data. Upon
  2729. selecting the save button,ADPro will analyze the available raw image data to
  2730. determine if it is an arbitrary color image,a gray scale image,or contains only
  2731. shades of one specific primary color(such as cyan,yellow and magenta). This
  2732.  
  2733.                 125
  2734.  
  2735. FIGURE 14.1:THE PRIMARY POSTSCRIPT SAVER CONTROL PANEL.
  2736.  
  2737. analysis will affect how the PostScript saver will compose the final PostScript
  2738. output.
  2739. The PostScript saver itself is comprised of three control screens. The first of
  2740. these screens is presented in figure 14.1.
  2741. The format of the PostScript output can be either Encapsulated(EPS)or Non-
  2742. Encapsulated PostScript. For inclusion of the saved PostScript data into other
  2743. programs,select Encapsulated.
  2744. The type of PostScript data to be saved can be grayscale,color,or separation
  2745. data. If you select color PostScript,the resulting file will make use of the
  2746. PostScript color extensions and can be sent directly to a color PostScript
  2747.  
  2748.                 126
  2749.  
  2750. compatible printer. Unless you have a printer capable of supporting color
  2751. PostScript,the grayscale choice is the appropriate selection. This will allow
  2752. you to get a gray scale representation of your image right off of your
  2753. PostScript printer. If you are processing color separation data(ADPro will
  2754. determine this in the data analysis phase mentioned above)you can select a
  2755. special setting which will include color separation specific instructions in
  2756. the resulting PostScript file.
  2757. The mode field allows you to specify that the image data will be saved in
  2758. either binary or ASCII form. Binary form is much smaller than ASCII but can
  2759. only be used with PostScript printers which are communicating via AppleTalk
  2760. (registered trademark of Apple Computer)or some other similar printing capable
  2761. network. For most ADPro users,the correct setting is ASCII.
  2762. For non-Encapsulated PostScript output,the following options are available on
  2763. this first control panel.
  2764. Page width and height defines the logical size of the PostScript page. Remember
  2765. that optional features such as registration and crop marks exist and are
  2766. printed outside the logical page. Therefore,you must leave room for thm on the
  2767. physical page should you want them.
  2768. Image width and height defines the size of the box in which the image will be
  2769. printed. The actual size of the image is effected by these values as well as
  2770. whether or not the original aspect of the image will be preserved.
  2771. The x and y offset of the image within the logical page specifies where the
  2772.  
  2773.                 127
  2774.  
  2775. FIGURE 14.2:VARIOUS POSTSCRIPT METRICS.
  2776.  
  2777. upper left hand corner of the image box will be relative to the upper left hand
  2778. corner of the logical page.
  2779. The goal in designing ADPro's PostScript saver was to provide the maximum
  2780. amount of flexibility to the user. This comes at the cost of some confusion,
  2781. however,since we provide so many ways of adjusting the output image. The
  2782. possible confusion may be alleviated somewhat by figure 14.2.
  2783. In figure 14.2 notice that the registration and crop marks appear outside the
  2784. logical page. Also note that the amount of overlap of the logical page and the
  2785. crop marks is determined by the bleed setting. Be sure to set aside space on
  2786. the physical page(by reducing the size of the logical page)if you wish to be
  2787. able to see all requested crop and registration marks.
  2788. Pressing the button marked additional options takes you to the second
  2789. PostScript control panel shown in figure 14.3.
  2790.  
  2791.                 128
  2792.  
  2793.  
  2794. FIGURE 14.3:THE SECOND POSTSCRIPT SAVER CONTROL PANEL.
  2795.  
  2796. Here,you may specify the angles and densities to be used in the PostScript
  2797. output file.
  2798. The gadget marked C/R Dns allows you to specify the Cyan density(all densities
  2799. are in lines-per-inch)for color separation PostScript files or the Red density
  2800. in color PostScript files. The gadget marked M/G Dns allows you to specify the
  2801. Magenta density for color separation PostScript files or the Green density in
  2802. color PostScript files.
  2803. Similarly,the gadget marked Y/B Dns allows you to specify the Yellow density
  2804. for color separation PostScript files or the Blue density in color PostScript
  2805. files.
  2806. Finally,gadget marked K/K Dns allows you to specify the Black density for gray
  2807. scale,color separation and color PostScript files.
  2808.                 
  2809.                 129
  2810.  
  2811. Note that when printing gray scale image data(different from printing a color
  2812. image in gray scale PostScript)only the black density is used.
  2813. The gadget marked C/R Ang allows you to specify the Cyan angle(all angles are
  2814. in degrees)for and color separation PostScript files or the Red angle in color
  2815. PostScript files. The gadget marked M/G Ang allows you to specify the Magenta
  2816. angle for color separation PostScript files or the Green angle in color
  2817. PostScript files.
  2818. Similarly,the gadget marked Y/B Ang allows you to specify the Yellow angle for
  2819. color separation PostScript files or the Blue angle in color PostScript files.
  2820. Finally,gadget marked K/K Ang allows you to specify the Black angle for gray
  2821. scale,color separation and color PostScript files.
  2822. In figure 14.3,the button marked Use Dns/Ang can be toggled between that value
  2823. and Ignore Dns/Ang. When set to Use Dns/Ang the PostScript file will contain
  2824. instructions telling the printer use the angles and densities that you have
  2825. specified. When set to Ignore Dns/Ang,the values you specify are ignored.
  2826. Instead the PostScript file contains instructions telling the printer to use
  2827. its own internally stored default angles and densities.
  2828. You may wish to set this button to the Ignore Dns/Ang setting if you are
  2829. working with a sophisticated printer which may have finely turned settings
  2830. already stored in its firmware.
  2831. The button marked Portrait can be toggled between that value and Landscape.
  2832. Selecting Landscape rotates the logical page(see figure 14.2)by 90 degrees.
  2833.  
  2834.                 130
  2835.  
  2836. Registration marks can be toggled on and off with the button labelled Reg
  2837. Marks. Similarly,crop marks can be toggled on and off with the button labelled
  2838. Crop Marks.
  2839. Note that crop and registration marks appear outside the logical page(see
  2840. figure 14.2). Remember to take this into account when specifying the page
  2841. dimensions by ensuring that the logical page plus the space set aside for crop
  2842. and registration marks can fit on the physical page.
  2843. The gadget marked Bleed controls how much the crop marks(if present)will
  2844. overlap into the logical page.
  2845. The button marked Ignore Aspect in figure 14.3 causes the image to be stretched
  2846. as needed to fill the entire image width and height. Clicking on this button
  2847. will toggle it to its other value,Keep Aspect. In this state,the image will be
  2848. stretched to fill only one dimension of the specified image area. The other
  2849. dimension will be stretched to match the scaling of the first dimension.
  2850. Depressing the button marked Additional Options leads you to the final
  2851. PostScript saver control panel shown in figure 14.4.
  2852. In this figure,the gadgets marked Offset X and Offset Y allow you to specify
  2853. the offset of the lower left hand corner of the logical page relative to the
  2854. lower left hand corner of the physical page. The gadget marked Rotation allows
  2855. you to rotate the entire page about its lower left hand corner.
  2856. The button marked Eject Page in figure 14.4 may be toggled between that state
  2857. and Don't Eject. When set to Don't Eject the PostScript file will contain 
  2858.  
  2859.                 131
  2860.  
  2861. FIGURE 14.4:THE THIRD AND FINAL POSTSCRIPT SAVER CONTROL PANEL.
  2862.  
  2863. instructions telling the printer not to eject the page when it is finished
  2864. rendering inside the printer. This allows you to send additional pages which
  2865. will be overlayed over the first. If set to Eject Page,the resulting PostScript
  2866. file contains instructions telling the printer to eject the page as soon as it
  2867. is completely rendered within the printer.
  2868. The button marked Positive allows you to specify that you wish a positive or
  2869. negative rendered on the printer. To create a set of negative films(used for
  2870. most printing applications)you would set this button to its other state,
  2871. Negative. A special feature of the ADPro PostScript saver is that it will
  2872. actually produce a true negative even on PostScript printers which do not
  2873. support the standard PostScript negative operator such as the Apple LaserWriter
  2874. series.
  2875.  
  2876.                 132
  2877.  
  2878. The button marked Normal in figure 14.4 toggles between that state and Mirror.
  2879. This button,used in conjunction with the Positive/Negative button will allow
  2880. you to create mirror image negatives which is the standard used by professional
  2881. printers. A special feature of the ADPro PostScript saver is that it will
  2882. actually produce a true mirror image even on PostScript printers which do not
  2883. support the standard PostScript mirror operator such as the Apple LaserWriter
  2884. series.
  2885. Auto Feed specifies that the PostScript file should contain instructions
  2886. telling the printer to take paper from its standard paper tray. Toggling this
  2887. button to Man Feed causes the PostScript file to contain instructions telling
  2888. the printer to insist on a manually feed sheed of paper even if paper is
  2889. available in its standard paper tray.
  2890. Finally,the gadget marked Copies allows you to specify the number of copies
  2891. that the printer will be told to make of each page output.
  2892. On each control panel,hitting Cancel will cause any changes made on that
  2893. control panel to be ignored. You will be returned to the previous control
  2894. panel. If Cancel is selected from the fist control panel,then the PostScript
  2895. saver will exit and no image will be saved.
  2896. To accept changes made to a control panel,select the button marked Accept. This
  2897. will cause the specified changes to be reflected in the next document you
  2898. output. Hitting the Accept button from the first control panel will cause the
  2899. file requester to appear.
  2900. Using the file requester you can select the name of the file into which the
  2901. PostScript output will go.
  2902. To select a printer device directly,blank out the drawer string and insert the
  2903.  
  2904.                 133
  2905.  
  2906. name of the printer device in the file string. For example,to print to
  2907. prt:,blank out the drawer string and insert prt: into the file name string.
  2908.  
  2909. 14.8 SCULPT
  2910. The SCULPT saver requires the presence of 24 bit-plane raw image data. The file
  2911. requester will appear three times. Use it to select the names of the red,green
  2912. and blue component files. Remember that you must explicity keep track of the
  2913. width and height of the image in order to make use of it again in the future.
  2914. While this format handles raw image data,it does not contain its own color
  2915. look-up tables. Therefore,in order to preserve the effect of any color balance
  2916. settings you might wish to maintain,use the apply map operator to transfer the
  2917. effect of the color settings into the raw image data.
  2918.  
  2919.                 134
  2920.  
  2921.             CHAPTER 15 - STANDARD OPERATORS
  2922.  
  2923. This section gives detailed information about each Operator included in the
  2924. standard ADPro distribution.
  2925.  
  2926. For general information common to all Operators,please see Chapter 7.
  2927. For information about how each specific Operator may be accessed from ARexx,
  2928. please refer to Chapter 16.
  2929.  
  2930.             PAGES 135 & 136 ARE BLANK
  2931.  
  2932. 15.1 APPLY MAP
  2933. Changes made with the color controls such as brightness or gamma do not
  2934. actually change any of the raw image data. Rather,these changes affect only
  2935. look-up tables through which the raw image data is filtered. Therefore,the
  2936. affect of changes made with the color controls can be undone.
  2937.  
  2938.                 137
  2939.  
  2940. The apply map Operator applies the changes made with the color control to the
  2941. actual raw image data. It then resets the color controls to a neutral setting.
  2942. Three uses of this Operator come immediately to mind.
  2943. 1. It allows the range of the color controls to be extended by allowing you to
  2944. repetitively apply color control changes over and over again.
  2945. 2. It allows for better results when merging images using the image compositing
  2946. feature of ADPro. For instance,you might want to merge an image with bright
  2947. color settings with an image with dark color settings. Using this Operator on
  2948. both images prior to compositing will allow you to get the desired results.
  2949. 3. It allows other Amiga programs which can read 24 bit-plane IFF images but do
  2950. not parse "color look-up table chunks" to get the image data you intended.
  2951.  
  2952. 15.2 COLOR TO GRAY
  2953. The color to gray Operator provides three very important benefits beyond simply
  2954. turning color images into gray scale images.
  2955. First,the method used within ADPro to covert from color into gray scale can
  2956. actually produce gray scale data of considerably better quality than the
  2957. original color data. For example,the Sharp JX-100 portable scanner is accurate
  2958. in gray scale to 6 bit-planes and 18 bit-planes in color. However,when ADPro
  2959.  
  2960.                 138
  2961.  
  2962. converts an 18 bit-plane color image into gray scale,it produces a gray scale
  2963. image which is accurate to 8 bit-planes.
  2964. Second,ADPro renders extremely well in gray scale due to its dithering
  2965. capabilities and the fact that 16 gray scales cover the range of gray
  2966. proportionately better than 16 colors cover the spectrum of all possible
  2967. colors. For this reason,a high resolution interlaced gray image rendered with
  2968. ADPro can look very nearly photographic even given the Amiga's limited display
  2969. capability.
  2970. Third,this feature provides a way to covert color images into high quality gray
  2971. scale images for the purpose of black and white desktop publishing. While color
  2972. DTP is just now coming into its own,DTP is still predominantly gray scale.
  2973. Selecting color to gray will initiate a conversion of 24 bit-plane color data
  2974. into gray scale. You will be told if there is no 24 bit-plane color data
  2975. available to convert. After the conversion is complete,select a screen format,
  2976. number of bit-planes,and finally depress the execute button if you wish to view
  2977. the resulting data.
  2978.  
  2979. 15.3 CROPPING
  2980. The cropping operator can be used to specify a rectangular region within an
  2981. image which will be preserved. All data outside the selected region will be
  2982. discarded.
  2983. When the cropping operator is selected,it will bring up a control panel into
  2984. which you can specify the offset of the top left-hand corner of the rectangle
  2985. to be preserved. You specify the width and height of the area to be preserved
  2986.  
  2987.                 139
  2988.  
  2989. as well. Note that you cannot specify a negative offset nor can you specify a
  2990. combination of offsets and width or height which would exceed the width or
  2991. height of the original image.
  2992. Aside from the straightforward use of this operator for cropping,you can also
  2993. use this operator to "focus" ADPro's color picking technology. See section
  2994. 12.11 for more informaion.
  2995.  
  2996. 15.4 DYNAMIC RANGE
  2997. The dynamic range operator performs two passes over any raw image data
  2998. currently loaded in memory. During the first pass,the smallest and largest
  2999. values contained in the raw image are found. Then,a control panel appears,
  3000. displaying the values that were found in the first pass. If you select and
  3001. accept a new maximum and minimum value,a second pass over the raw image is
  3002. performed(mapping all of the contained image data to lie between the selected
  3003. maximum and minimum).
  3004. This Operator can be used in many different ways. It can be used to expand or
  3005. contract the dynamic range of an image(by increasing or decreasing the spread
  3006. between the maximum and minimum values). It can also be used as a hybrid
  3007. contrast/brightness manipulation.
  3008.  
  3009. 15.5 GRAY TO COLOR
  3010. The gray to color Operator provides the logical inverse of the color to gray
  3011. Operator. This Operator reformats the internal data representation of raw gray
  3012.  
  3013.                 140
  3014.  
  3015. scale image data into that of raw color image data. This feature is provided so
  3016. that you can perform all image processing functions on both color and gray
  3017. scale images.
  3018. When combined with image compositing,interesting artistic effects can be had.
  3019. For example,a masked color image can be "pasted" into an otherwise completely
  3020. gray scale image for a startling effect. See section 12.9 for more information.
  3021.  
  3022. 15.6 HORIZONTAL FLIP
  3023. Many applications require the production of mirror images of the original data.
  3024. Specifically,this is required by screen and heat-transfer printers. Selecting
  3025. the horizontal flip command will horizontally flip any 8 bit-plane or 24
  3026. bit-plane data which might be currently loaded in memory.
  3027. Note that performing a horizontal flip followed by a vertical flip is the same
  3028. as rotating the image 180 degrees. This can be used in conjunction with the
  3029. orientation button to rotate images through 0.90,180,and 270 degrees.
  3030.  
  3031. 15.7 LINE ART
  3032. When 8 bit-plan gray scale data is available,selecting the line art operator
  3033. invokes a proprietary edge emphasis algorithm. The result is an image which
  3034. contrains the most prominent edges in the original imge.
  3035. The production of quality line art from an arbitrary gray scale bit-map is 
  3036.  
  3037.                 141
  3038.  
  3039. quite difficult. It is important to begin with a high contrast original or to
  3040. boost the contast of the image before invoking the line art command.
  3041. Modifying the color controls(such as brightness,contrast,and gamma correction)
  3042. prior to executing the line art command will drastically affect the quality of
  3043. the resulting line art. Increasing the brightness,contrast,or gamma correction
  3044. of the image will also reduce the amount of clutter in the resulting line art.
  3045. In general,increasing the contrast setting is usually a good step.
  3046. After the line art command has been executed,the color controls such as
  3047. brightness,contrast,and gamma correction will only slightly affect the rendered
  3048. image. Decreasing brightness or contrast will thicken the lines in the image.
  3049. Increasing brightness,contrast,or gamma correction will thin out the lines in
  3050. the rendered image.
  3051. When working with the line art command,we suggest that you save the original 8
  3052. bit-plane gray scale data to disk before executing the command. In this way you
  3053. can reload the original 8 bit-plane gray scale data and retry the command with
  3054. different brightness,contrast,and gamma correction settings.
  3055. Note that executing the line art command will reduce the size of the available
  3056. image data by 2 pixels in width and height.
  3057.  
  3058.                 142
  3059.  
  3060. 15.8 NEGATIVE
  3061. The negative operator inverts any raw image data currently loaded in memory. 
  3062. For gray scale data,this produces what would commonly be called a black-and-
  3063. white negative image of the original data. For color image data,each primary
  3064. color is inverted separately.
  3065. This Operator requires the presence of raw image data in memory.
  3066.  
  3067. 15.9 RECTANGLE
  3068. The rectangle operator can be used to draw filled and unfilled rectangles into
  3069. a color or gray scale image. Selecting this operator causes the rectangle
  3070. control panel to appear. This control panel is shown in figure 15.1.
  3071. Using this control panel you can specify the location of the upper left-hand
  3072. corner of a rectangle as well as its width and height. You can also specify the
  3073. thickness of the rectangle. The default thickness is one which means that a one
  3074. pixel thick rectangle will be drawn. Since you specify the outside dimensions
  3075. of the rectangle,any additional thickness will be drawn within the inisde of
  3076. specified region. A thickness of -1 causes a filled rectangle to be drawn.
  3077. You may also specify a mix value to be used in the drawing computation. A mix
  3078. value of 100 is the default which indicates that drawn pixels shall completely
  3079. obscure any pixels from the original image which they overlap. For more
  3080. information see section 5.5.
  3081.  
  3082.                 143
  3083.  
  3084.                   RECTANGLE
  3085.                   OPERATOR
  3086.  
  3087. LEFT            0        TOP            0
  3088. WIDTH            0        HEIGHT            0
  3089. THICK            1        MIX            100
  3090.  
  3091. RED                GREEN            BLUE
  3092. 0                  0              0
  3093.  
  3094.         DRAW                CANCEL
  3095.  
  3096. FIGURE 15.1:THE RECTANGLE CONTROL PANEL
  3097.  
  3098. Lastly,you may specify the red,green and blue content of the color to be used
  3099. in drawing the rectangle. When drawing a rectangle in a gray scale bit map,only
  3100. the red value is used to determine the shade of the rectangle. Colors are
  3101. specified in the range of 0 to 255.
  3102. The rectangle operator can be used to draw borders around or create drop
  3103. shadows for rectangular regions.
  3104.  
  3105. 15.10 REMOVE ISOLATED PIXELS
  3106. The RIP Operator is used to "clean up" an already rendered image. It does so by
  3107. examining each pixel in the rendered image data in succession. If the
  3108. surrounding 8 pixels are the same color,and the center pixel is a different
  3109. color,the center pixel is replaced with the surrounding color.
  3110.  
  3111.                 144
  3112.  
  3113. We have found that RIP can "clean up" a majority of unwanted artifacts when
  3114. rendering images with a small number of colors,such as a colored logo. RIP is
  3115. less useful,though it can produce some artisitic results,when used on color
  3116. scans or other true color bitmaps.
  3117. In order to use RIP,you must have first rendered an image into 2,4,8,16,32,64,
  3118. 128,or 256 colors or gray scales. RIP does not operate on HAM images.
  3119. After rendering the image,selecting the RIP Operator and depressing the execute
  3120. op button causes the operation to take place.
  3121. RIP operates directly on the rendered image data. Therefore,aborting a RIP in
  3122. progress will result in a partially RIPped image.
  3123.  
  3124. 15.11 SCALING
  3125. When 8 bit-plane gray or 24 bit-plane color data is present in memory,you may
  3126. digitally reduce or enlarge the width or height(or both)of the image. This is
  3127. useful in a number of ways. For example:
  3128. The individual pixels in an NTSC screen are not square. In fact,they are higher
  3129. than they are wide in low resolution,non-interlaced displays. However,the
  3130. pixels produced by many image sources such as scanners and 3D modelling
  3131. programs are perfectly square. This mismatch in aspect ration can result in
  3132. NTSC images which appear vertically stretched.
  3133.  
  3134.                 145
  3135.  
  3136. By reducing the height of an image to approximately 86 percent of its original
  3137. size,you can produce images with an accurate aspect ratio for NTSC screens.1
  3138. Various artistic effects can be accomplished by reducing the width and height
  3139. individually.
  3140. You can create low resolution interlaced images easily by reducing the width
  3141. alone by 50 percent and then enabling interlaced mode.
  3142. You can create high resolution non-interlaced images(such as in the preparation
  3143. of icons for the WorkBench)by reducing the height alone by 50 percent.
  3144. You can cause an image to fit into any desired standard screen size. You can
  3145. preserve the image's aspect ratio by reducing both the width and height by the
  3146. same amount. Or,you can reduce the width and height by different amounts.
  3147. You can produce a special effect called "pixelization" or "posterization" by
  3148. significantly reducing the image and then significantly enlarging it.
  3149.  
  3150. Selecting the scale button when raw data is available in memory will cause the
  3151. scaling control panel(shown in Figure 15.2)to appear.
  3152. -------------------------------
  3153. 1 Since the actual aspect ratio of a given screen will vary from monitor to
  3154. monitor,the figure of reducing an image's height by 14 percent is only
  3155. approximate. Also,PAL video is much closer to square than NTSC. Therefore,PAL
  3156. screens may not require adjustment at all.
  3157.  
  3158.                 146
  3159.  
  3160.                  VARIABLE REDUCTION
  3161.                     SOURCE        RESULT
  3162. WIDTH                      640        640
  3163. HEIGHT                      400        400
  3164. ASPECT                    10:11        10:11
  3165.  
  3166.                  PERCENT REDUCTION
  3167. WIDTH                            100
  3168. HEIGHT                            100
  3169.                    SWITCH
  3170. RESET                   ACCEPT        RETURN
  3171.  
  3172.         FIGURE 15.2:THE SCALING CONTROL PANEL.
  3173.  
  3174. You can switch between enlargement and reduction by selecting the button marked
  3175. switch. At any one time,you can either reduce or enlarge but not both.
  3176. Using this control panel,you can specify a reduction or enlargement in two
  3177. ways:
  3178. 1. You can specify the number of pixels to be the resulting width and/or height
  3179. using the supplied string gadget.
  3180. 2. You can specify the percent of reduction(or enlargement)of the width and/or
  3181. height using the slider or string gadget.
  3182.  
  3183. When using the keyboard to enter values,the RETURN key will toggle between the
  3184. width and height percentage of change or the new width and height in pixels
  3185. depending upon which pair of gadgets are active. ALT-RETURN will toggle between
  3186. the pairs of gadgets.
  3187.  
  3188.                 147
  3189.  
  3190. To reset the values to what they were when the control panel first appeared,you
  3191. can select the reset button. To ignore any scaling you might have specified,you
  3192. can select the cancel button.
  3193. To accept a set of reduction or enlargement values,simple select the accept
  3194. button or depress SHIFT-RETURN from the keyboard. Unlike other Operators,
  3195. scaling operations are initiated immediately after acceptance.
  3196. Quality digital scaling requires massive computation. The computation time of
  3197. ADPro's scaling facility is proportional to the size of the resulting image.
  3198. Also note that scaling permanently alters the raw data in memory. After an
  3199. image has been saled,you would have to reload from disk in order to get back
  3200. the unscaled data.
  3201.  
  3202. 15.11.1 PIXEL ASPECT
  3203. Some file formats such as the IFF format support the storing of a pixel aspect
  3204. ratio with the file. When ADPro loads a file in a format supporting a pixel
  3205. aspect ratio specification,it presents this information in the scaling control
  3206. panel as shown in figure 15.2. The pixel aspect defaults to "1 to 1" when ADPro
  3207. loads a file which does not contain any pixel aspect information.
  3208. ADPro maintains the pixel aspect information as scaling operations take place.
  3209. The aspect shown in the Source column in figure 15.2 represents the current
  3210. pixel aspect. The aspect shown in the Result column represents the pixel aspect
  3211. which would result from the currently defined scaling operation if it were to
  3212. be executed.
  3213.  
  3214.                 148
  3215.  
  3216. 15.12 TRANSPORT CONTROLLER
  3217. Selecting the Transport_Controller Operator causes ADPro to look for a running
  3218. copy of MicroIllusions' Transport Controller. If found,ADPro will communicate
  3219. with the Transport Controller to record the Amiga displayable image currently
  3220. in memory.
  3221. This Operator requires the presence of rendered image data in Amiga displayable
  3222. format. It will also tell you if it cannot locate a currently running Transport
  3223. Controller.
  3224. The Transport Controller operator is not supported in the A-RES or A-HAM modes.
  3225. Control will return to ADPro when the Transport Controller is through recording
  3226. the image. The number of frames to be recorded is determined by the default
  3227. value maintained by the Transport Controller. Direct control(from within ADPro)
  3228. over the number of frames to be recorded is provided only via ARexx since the
  3229. Transport Controller provides a user interface of its own.
  3230.  
  3231. 15.13 VERTICAL FLIP
  3232. Many applications require the production of mirror images of the original data.
  3233. Specifically,this is required by screen and heat-transfer printers. Selecting
  3234. the vertical flip command will vertically flip any 8 bit-plane or 24 bit-plane
  3235. data which might be currently loaded in memory.
  3236. Note that performing a horizontal flip followed by a vertical flip is the same
  3237.  
  3238.                 149
  3239.  
  3240. as rotating the image 180 degrees. This can be used in conjunction with the
  3241. orientation button to rotate images through 9,90,180,and 270 degrees.
  3242.  
  3243.                 150
  3244.  
  3245. ART DEPARTMENT PROFESSIONAL DOCS BROUGHT TO YOU BY THE SOUTHERN STAR WITH THE
  3246.             ASSISTANCE OF RAP....
  3247.  
  3248.